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Choose licensing models and protection keys completely independent of the protection process- 
at any time throughout the software lifecycle. Advanced, but easy to use, HASP SRM delivers 
enhanced marketing power and takes sofWare rights management to a whoie new level 1 


Request a FREE HASP SRM Developer Kit at wwwAladdin.com/MT8 


* NORTH AMERICA: 1-800-S62-2543, 847-818-3800 

• UK • GERMANY • ISRAEL • BENELUX • FRANCE • SPAIN • ITALY' INDIA • CHINA • JAPAN 

O Ataddin Knowfedge Ltd. Ail fighs reserved. AfecWin and HASP a/e regiitered tfadcmaritj; HASP SRM isa Vademai oi Alalifin iCowSedgeS^ms, LtcL 


li'* VI 




Frost & sulVmn 

2007 Product Irmovation Award 
Software DPM 


( -200SSI1A I 

//CODiE// 


STM CODff Awerci!r 

loosf^ifst 
Software OAM 


Aladdin 

SECURING THE GLOBAL VILLAGE 


www.Aladdin.com/HASP 











TABLE OF CONTENTS 


Articles & Departments 


RubyCocoa 

A new way to write Cocoa applications—Part 2 

by Rich Warren .... ..... , 8 

Mac in the Shell 

File Manipulation with PHP 
... and other tips 

by Edward AAarczak . 20 

The Road to Certification—Part 5: ACSA and ACTC 

Increase your knowledge and build crediInRty along the way 

by Doug Hanley . 30 

Test-Driven Development Using AppleScript—Part 2 
Creating AppleSaipt apphcathns using ASUmt 

by Andy Sylvester . 36 

The iPhone SDK 

Overview and iaitial reactions 

by Rich Warren . .54 

The Road to Code 

Cocoa Puffs 

Views, controls, actions, notifications, and d^egates 

by Dave Dribin . 66 

Getting Started with REALBasic 
Learning the ropes 

by Norman Palardy . . 74 

Moving Targets 

Lei^d's new mobde cations Ad/f you better nuatage nudiile computers 

by Greg Neagle, MacEnlerpnse.org . 78 

Introduction to Core Animation 

Using Core Animation in your Cocoa ig^licatioas 

by Marcus S. Zarra . 82 

MacTech Spotlight 

Alexander Schoen & Peter Maurer 

Many Tricks . 88 


Tabi£ Of Contents 5 

















I 


From the Editor 


7 ■here are many interesting tilings happening in the Apple world tcxJay: iPhone improvemenLs, Leopard 
inprovements, better availability of coiniminity tools that help everyone, and more. My mind has been drawn to all 
of tliem on some level, iind tliat’s being lx>me out in the pages of MaeTech. like many wisdom iraditions, the tech 
world really operates on two levels. One is iJie heads-down things that interest you at die mtjment. You need to establish 
a liierarchy of Open Directory Repliots tliat serve 12 disparate offices. You need to solve an 1/Q Ls.sue on a .server, or, 
you need to add some nifty CoreAnimation effects to an application. The second level is The Big Picture. Each of the 
level one projects are part of a greater whole. Wliat liappens in one realm affects the other. More importantly, 
understanding in one realm impnjtm the work you do in otheni. 

To this effea, weVe lieen running Si^Eiie more \leveioper4sh” type of content Bui die .sysadmin content lives on. 
Or, are tliey Ixaii part of a greater whole? If you’re a devek>|>er, your application writes to a .server. Those reads are writes 
are subject to pennissiuns on die server - something we talk about often. Conversely, if you're a sysadmin, and are 
troubleshooting a problem, it’s great tt> lie alile to read die source that Apple provkles us (see 
hltp://devdoper.apple.com/opensource). Even Ix^tier: it’s nice - il' not essential - to lie able to provide custom 
solutions for your environment. TliLs is done tlirough programming. Call it scri[iting, call it development, or call it being 
learned; it's all a }Mrt of iht^ ^rvaler technical whole. 

On to thi.s month's issue. On die cxwer the iPhone SDK. At die time of diis w riting, the bulk of the SDK is still under 
NDA, and we'll be bringing you greater coverage when we're able. For die time Ix^ng, Rich. Warren gets you up to speed 
with the current state of the iPhone SDK. 

Rich also brings up part 2 of his RubyCoooa article. A[>ple Ls making a litild statement by making Ruby and other 
"scripting” languages available in Xoxle and aiile lo access Ccxoa calls. Tlie bar lias been lowered (or exjianded, 
depending on your point of view) for full, Macmalive, application development. 

Doug Hanley fills in the limil piece of the Leopold certification puz^^le. Part S: ACSA and ACTIl vnis slighUy delaycxl 
as parts of die course w'ene still Ixdng decided on when it was initially to lie written. Thast* details have been worked 
oLii, and Doug lias the deliils for you. 

Kcfieatable testing, or IJnii Testing, is a hot topic. Justifiably so. Automated tc^ls help to ensure that changes and 
updates don't break something else along die way. Andy Sylvester brings us the .sec'ond (lart of Test-Driven Development 
Using AppleScript. Lcam to confirm Ufxiates using ASUrdt, 

Dave Dribin once agiiti leads us down Hie Road to Code. If you’ve Iieen Ibikiwing along st> far, you're iiixibably 
prelty capable alxxii now. Of course, tlieie's always more to leam! I'liis month, Dave dives deeper into some more Cxx'oa 




intricacies. 

For those of you feeling a little mom advanced, Marcus Zana talks alxxii CoreAnimation. Learn to add this amazing 
new tcx'linolugy to your Gxoa application! 

Gieg Neagle wiiles this month's MacEnterprise column, focusing on Managed Pieferences for mobile machines. This 
Ls an oft-requested topic, and Greg speils it out nicely! 

Norman Palardy intrcxluces us to REALBask, tlie firsi in a series to gel fieople up to sjieed with tliis wonderfully 
useful development environment. Again, we have a Ux)i that lowers the bar to creating customized, native OS X solutions. 
REALl^iisic provides an integrated TDE and debugger, along with metlxxLs to tafi into Ctx:ai API calls. Easy to get into, 
lull powerful enough io write as sopliislic'iited an application as you cc^uld imagine. 

This montli's Mac In The Shell wraps up coverage of PI IP xs a generic scripting language. Uie promised file 
niiinipulalion techniques and more are presented. 

liist, but not least: Check out Alexander Schtx^n and Peter Maurer erf Many Iricks in tilts month’s MaeTech Sjxxlighr. 
.Many Tricks pRKiuce tlie popular yFlicks, Which and Desktop (mitain applications...imd more, so, give 'em a IcKik! 

Finally, WWDC time is nigh! We hope to see everyone in San Franciso lor wliat prtrmLses to a very exciting 
confenenc'e. Until next month, enjoy! 


Ed Marezak, 
Executive Editor 
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RubyCocoa 

A new way to write 
Cocoa applications—Part 2 
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Uy niOfl 

j 



Last Umej wc usi3tl RiibyCtJCoa lt> l^uild a basic RSS feed 
reader Now, let’s shift tilings into high gear. If a feed inckides 
an audible enclosure, we want to download the file and send 
it to iTunes. We will also explore the debugging options for 
RubyCocoa, and lcx)k at a few cool Ruliy tricks. 

But, before we get started, there’s a little bit of necessary 
housekeeping. If you haven’t done so already, grali the article’s 
source code from lip.macteGh.com/src/mactech/ 
volume24_2008/24.05.slK 

Now, we need to install the RubyOSA library, Again, we 
can do this using RuhyGems. Hroin the command line, iypt^: 

sudo gera install rubyosa 

If you remember, last time we had srmie trouble with the 
PeedRcader library after upgrading OS X to 10.S.2. Well, 
RubyOSA has its own little problems, 

RubyOSA depend.s on libxmi-mby. OS X comes with 
version 0.3,8.4 already installed, and RubyOSA sliouki work 
fine with this. Unfortunately, other RubyGem commands might 
update libxml-ruhy to version 0.5.2.0. This will break RubyOSA. 

If you're worried, try gem list libxml ruby. If the 
command returns libxml-ruby CO.5,2.0, 0.3,8,4}, 

then you liave both versions installed. Simply uninstall the 
0.5.2.0 version: 

sijcio gem uninfitall libxml ruby -version 0.5.2.0. 

If all else fails, uninstall both Itlixml-niby and RubyOSA, 
T'hen reinstall RubyOSA. 

Sending Files to iTunes 

Go ahead, build and launch the application. Suliscribe to 
an RSS feed. Subscribe to a podcast. Now, click on .some of the 
feeds. 

Thanks to the magic of Bindings, the "Send To iTunes” 
button remains disabled until we select an audio Enclosure. 
We just need to send this enclosure to iTunes. More 
importantly, we want the file to show up in a RubyRSS playlist. 
We could do this w'ith AppleScript, but I have issues with 


AppleScript. I won’t go into the gory details here. Suffice it to 
say, AppleScript knows what it did, and I’m still waiting for an 
apology. 

14>rtunately, we have a l>etter way. I’he RubyOSA library 
tiasically wraps AppleScript aills in gotx.1 old Rul)y code, 

St>j let's gel started. First, we want to generate the Al^I 
dociimentaiirin for iTunes, Fortunately, RubyOSA comes with a 
command line tool for building rdoc-siyle himl pages. JVlake 
sure i'funes is running. Open Terminal and navigate to the 
de.sired directory. Then type the following command: 

rdoc-osa -name iTunes 

Give it a few seconds, and you should have the complete 
i times documentation. Unfortunately I sometimes find the 
RubyOSA dtx'iiiiientation hard to follow. It’s a good starting 
point—but ! often find myself firing up the Script Editor and 
opening r!ic application’s Dictionary directly. Between the two, 
I can usually figure out what’s going on. 

I also recommend using irli when developing RubyOSA 
code. If you’re not sure what something does, , well. . .try it 
out and see. Ruby also lets you inspect the details of all your 
tilijects, and you can find a lot of useful infomiation this way. 
Try this. iLiunch irh, then enter the following commands: 

>> require ' ruby' 
false 

>> rs^quire ‘rbosa' 

■> true 

>> app = 0SA*app{*iTunes') 

<0SA::ITunes::Application:0x5b85ec 
desc-"'sign' ($6BfiF6F6E$) "> 

>) app.class 

“> OSA::ITunes::Application 
>> app.methods 

="> [‘'current_encoder'*, "inspect”, “ta_ysinl_styl€”, 

"'version*', "'set*', "frontmost?". . , . 

OK, enough chatter; let’s get back to our code. 
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“We Make Mac Networking Child’s Play.” 



Hello, 

We’re Small Tree Communications, 
The Mac networking experts. 

Founded in 2003, by a group of 
talented networking and kernel 
engineers with high performance 
supercomputing experience, Small 
Tree Communications sells and 
supports high speed networks to 
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■ SAVE TIME on really big file 
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■ BAN THE SAN: Save your money, 

share your stuff 


Run Faster 

‘We make all your stuff run faster” 


^ it X»S‘ 


It’s so easy, it’s child’s play, 

Send an enaaiJ to lo the subject line tyjio AftlC-Owr, and then tell us about your puin. jind why you think yuu deeeni^tf ci 

MaC’Over. The wiunifr will recaivo a Ct^TTlpletH COttSUllQllOtt, expilTt tldvics and Small Tit>e products lo Mac-Qvor their uetwork. 

All entries will receive a discount coupon good for 10% Off ^ny Small Tree product. 

To see oil uttr Liiot toys, visit us at 'jis . • ' ' ■ i ■ . vitijl 



Small Tree Communications 7800 Hudson Bivd,, Suite 110» Oakdale, MN 55128 866.STC.4MAC email: rurifaster@small-tree.com 







file = app.add[file. playlist) 


Again, we should place the RubyOSA code in its own class. 
Create a new Ruby class named ItunesSender, rb. Now 
type in the following: 

ItunesSender. rb 

require * rubygems' 
require "rbosa" 
require 'opeu-Liri' 

f ItunesSender adds a playlist and songs to iTunes nsiug 
rbosa. 

nlass ItunesSender 
NAME = ^RubyRSS' 

# add ijjethods here 

end 

The required files should all make sense. We need 
mbygenis to access other gems libraries. RubyOSA lets us make 
scripting calls on iTunes, and open-uii lets us download the 
enclosure. 

As our one and only public metliod, download_f iles () 
will download the file from the provided URL, then it calls 
s e nd_f i 1 e () on the resu It. 

download Jite() 

# Downloads a file from tbe given url. 
def download_file(url) 

flle_nattie = "iflLWVt‘HOME'] !/DownioadsA 

If I get_flle_namG [url] I 

File,open{file_name, 'w') do |temp| 
open(url) do |flle| 
data ” file.read 
temp,write(data) 
end 

end 


send_flie (file,name) 

File.delete(file_narae) 

end 

Now for ihe helper methods. The send_fileC} method 
sends the file to the RubyRSS playlist in iTunes. 
Get_playlist () calls find_playlist () which searches 
for the RubyRSS playlist. If find_playlist () cannot locate 
the playlist, get_p lay list () creates one. 

Finally, get_flle_name () extracts the file's name from 
its URL. 

HunesSendet's Hdper Functiom 

private 

If Helper Function: adds the given file to the AtticleSandbox 
playlist on 
if iTunes, 

def send^fileffile) 

app = OSA.appUiTunes ') 

0SA.utf8_strings ^ true 

playlist - get_playlist(app) 


end 


If Helper Function; returns the ArticleSandbox playlist. 

If If the playlist does not exist, this will create It, 
def get_playlist(app) 

playlist = fiud_playlist(app) 

if playlist.nil? 

playlist ” app.niake(OSA:: ITunes: :UserPlayliEt) 
playlist.name = NAME 
end 

return playlist 

end 

If Helper Function: finds the existing ArtlcleSandbox 
If playlist. If the playlist does not exist, returns nil. 
def flnd_playlist(app) 

app.sources.each do |source| 

source.playlists.each do |playlist| 

return playlist if playlist.name = NAME 

end 

end 

return nil 

end 

If Helper Function; extracts the file name from the url. 
def get„file_narfie(url) 
url.split('/■).last 

end 

Now' we just need to link this into tlie main conirollcT. 
Again, initialize the ItunesSender object in the controller’s 
awake FromNib () method, 

@itunes_setider = ItunesSender .new 


Then update sendToItunesAction [ ]. 

sondTbltunesAcHonO 

If This action sends the currently selected Enclosure to 
iTunes. 

def sendToItunesAction(sender) 

index ■ @GnQlosures_table.selectedRow 
return if index < 0 


enclosure “ @enclo3ures.arranged0bjects[index] 

Thread.new do 
begin 

^progress. start Animation (self) 
@itijnes_sender, download_f lie (enclosure, url) 
^progress.stopAnimation(self) 
rescue Exception => e 
puts e.message 
OSX::NSApp.stop(self) 

end 

end 

end 

ib_actlon :sendToItunesAction 
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The Complete RubyRSS 


Again, this can take a long time, especially when 
downloading hour-long podcasts. So we spawn off another 
worker tliread. Wc also reassure our users by aniinatmg the 
progress indicator, and we catcii and log any errors that occur 
during the download. 

Iliads it. We're done (well, for a given value of done). 
Launch the application, and try sending an enclosure to iTiines. 
You may need to wait a bit. Go get a cup of copy. Go walk the 
dog, or re-sort your sock drawer* When you get hack, you 
should find the file in a newly created RubyRSS playlist. 


Debugging 

Our application looks pretty good, hut what do we do 
wlien things go wrong? As ! mentioned earlier, we c'annot use 
Xcode's huilt-in debugger (at least, not yet). But that does not 
leave us helpless in the face of hugs. We still have a number of 
powerful tools at our fingertips, 

hirst, we could use RLshy's built-in debugger, hut there’s a 
better option. Install tlie ruhy^dehug gem. 


-^ 


Mobile email 

for Windows Mobile, Palm, Symbian and BlackBerry 
powered by Kerio MailServer 

Get your emaih contacts, calendars and tasks synchronized with your favorite smartphone. 

Explore Kerio MailServer, a groupware suite for the office and the road. 
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<hi> SPICE UP THAT WEBSITE OF YOURS </hi> 


And spice up your relationship with search engines In ttie process. 

Now you do not have to choose between tasteful typography and good results In search engines, 
learn why and how at http://www.photofont.com 


Photo'^ont 
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sudo gem install ruby-debug 



LassoSoft.coin/LDC 


Early-Registration available now! 
See the Web site for complete details. 


Lasso supports the databases and 
technologies you need to untangle 
your Web infrastructure. Create 
Web applications using Lasso's 
powerful and easy to learn 
scripting language. 

Combine data from multiple data sources such 
as FileMaker, Oracle, SQL Server, and MySQL. 
Utilize advanced techniques for AJAX and Web 
2,0. Parse and publish calendars, RSS feeds, 
and more. Integrate with Google, PayPal, and 
Authorize. Net. 

Download the free Lasso Developer 8.5 today 
and try out Lasso for yourself. 

(^^iSSoSoft 

LassoSoftcom 



Now, we can add a breakpoint in our code U5ing the mby- 
debug API. Let's add a breakpoint to our main controller's 
awakeFromNibO method. First, import the ruby-debug 
library. 

require 'ruby-debug' 

Next, add a call to dehugger(). When we execute the 
code, it will stop at tlie debugger (} line, and dump control 
to the console. 

Adding Breakpoints 

We have programmatically added a ruby-debug break 
point to the awakeFromNlb () method. The 
debugger () call will halt execution and shift control 
to the debugger 

# Initializes the Main Window after it is loaded from the 
NIB. 

def awakeFtomNlb 

debugg^er this is our breakpoint 
©progress.setDisplayedWhenStopped (false) 

©posts.addObservet_forXeyPath_options_context(self, 
“selection ■*, 

0. nil) 

@feed_reader ” FeedReader.new(self, 

©app_delegate .managedOb j ectCotit ext} 

@itunee_Bender = ItunesSender.new 
end 


We netxl to rebuild the application before we can use the 
debugger More imponantly, we need to launch the application 
from the command line. Open Terminal, and navigate to the 
project’s directory. Now enter the following command: 

build/Release/RubyRSS.app/Contents/MacOS/RubyRSS 


You may need to change "Release" to "Debug”, depending 
on XcckIc’s configuration. If the command works, you should 
see something similar to the following: 

/Usefs/riMwarren/Desktop/RubyRSS/build/Release/RubyRSS.app/ 
Cont ents/Resou rces/MainCont roller.rb:24 
©progress.setDlsplayedWhenStopped(false) 

Crdb:!) 

We have now entered the interactive debugger. Type help 
to get a list of commands. 

(rdb:l) help _ 

ruby'debug help vO.10.0 

Type 'help Ccommand-name)* for help on a specific comand 
Available ccmnnands: 

backtrace disable exit itb pp restart step up 

break display finish list pa save thread var 

catch down frame method ptitl set toiate where 
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continue enable help next quit show trace 

delete eval info p reload source imdlspiay 

Coo!, yeah. But that's not all. RubyCocoa supports DTrace 
and Apple's Instruments. This gives us some incredibly 
powerful toc]ls for analysing our ccxie. 

For example, launch InstnimenLs. Then select die CPU 
Sampler template. Now, click on the Default Target drop down 
menu and select Launch Executable ft Choose Executable.*, 
Then navigate to our application (in the Project directory at 
build/Release/RubyRSS * app)* 

Click the Record butuin. when the RuhyRSS IJT comes up, 
press the Refresh Feeds button. Once finished, go back to 
Instalments and press Stop. That gives us CPU loads and a call 


The first argument, obviously, is the path to your Ruby 
code. Tlie diird aigument is also easy, RBBundlelnit simply 
passes tiiat id to your Ruby code as an argument. 

But, what about the objc_class? Well, here's the good 
news, you can just set it to nil. Just make sure you use an 
absolute path to your code. 

However, if you give it an Objective-C class, RubyCocoa 
will search for the bundle that contains the given class. It will 
then append that bundle’s Restmrces direcioi^ to Ruby’s 
$L0AD_PATH, 

If you plan to distribute your code, you will probably want 
your Ruby code eml>edded in the application bundle, just use 
one of your application's classes for obj c_class, then copy 
your Ruby code into the Resources direaory* 


tree for our application as it downloads and parses RSS feeds. And. if that trick isn't nearly cool enough. We can also use 

RubyCocoa to rcxjt arfiund in someone else's applications. 

However, this trick needs a little help from 
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our friends. Download Rubylnjeci from 
RubyCocoa’s Sourceforge page 

thnp://aibyctx;oa.sourceforge.net/). 

Unlar the downloaded file (you can just 
double dick its icon in the Finder). Now open 
Tenninal and navigate to tlie Riibylnject 
folder. You need to build and install the 
Ruby Inject framework. Enter these 
ct>mmand.s: 

xood^bulld SYMROOT^/tnip 

cp -r /tmplReleass/Rubylnject. framework 

/Library/Frameworks 


QK, now we iust need to run the 
Inject. rb command* But liefore we can do 
that, w^e need to get the prcxress id of our 
target application. Open Activity Monitor and 
look ffir the desired application. Pnx:ess IDs 
appear in the left-most column. 


Instruments' CPU Sampling 


Now run the following command: 


Two Last Cool Tricks 

Sure, building a RubyCocoii a[iplitation from the grounci 
up is great, but w^hat if you just want to add a bit of Ruby to an 
existing project? Nothing couki be simpler. Well. * .OK. . .a lot 
of things could l>e simpler. But it’s still pretty easy. 

RtibyCocoa includes an Objective-C funaion that executes 
arbitrary Ruby code, RBBundlelnit (). This function is 
declared in /System/Llbrary/Frameworks/Ruby- 
Cocoa*framework/Headers/RBRuntime*h, but Tve 
Cfipied it Ixflow. 

RBBundlelnitO 

int RBEundlelnit {const char* path_to_ruby_prograjn* 

Class objc_class. id additional^param)r 


sudo ruby iBjcct.rh <pld> 

This w'ill open up an interactive shell. If you would rather 
just am a script, then append the script name to the end of the 
command. 

sudo ruby inject*rb Cpid> Cscript name) 

For example, on my computer, iTunes’s pid is currently 
i{)14. The foliowing is a sample, interactive se.ssion. 

Sampie Ruhyfnect Session 
sudo ruby inject, rb lOH 
» require *osx/cocoa' 

^'true" 

» include OSX 
'‘Object'" 

» NSApp 

:XSApplicationlOxbaOcddfi class=‘NSAppllcatiDE‘ 
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id=0xll3ce0>” 

>> windows = NSApp.windows 

=> "/KOSX::NSCFArray:O 3 tb.a 0365 a class="NSCFArray' 
ld=Qxl77aati40>” 

)) windows.size 
=> “3" 

>> windows[0].title^to^s 
“) "\'’Activity MonitDr\”’‘ 

>) windows[1].title,to_a 

>> windows[2].title*to_s 

>> 

Note, I typed ctrl-D to quit the interactive session- 
ALso Note: you're not just limited to inspecting the code. 
You can make any valid Ruby (and in this case, RubyCocoa) 
calls- Look at Rubylnject's README file for more detaEs. 

Conclusion 

OveraE, 1 am impressed witli lioEi RubyCocoa and RubyOSA. 
Yes, die technologv' needs to mature a hit. It stEl h::Ls ttx: many 
roLigii edges and sharp comers, and yoia might have tRxible finding 
documentation. Also, RubyOSA stiE seems harder Eian it really 
needs to l>e. But, all in all, it’s nice to have this much pt)wer and 
llexibility f^uilt into Leopard. 

For tile purpcxse o( this Tutorial, f tried to push as much code 
into Ruby as possible. That, however, may not be the best solution. 
Rui)y and Objective-C have different strengtlis. This opens up 
interesting possibilities for hybrid applications. At the very teist, you 
will want to move the bottlenecks from Ruby to Objeciive-C. 


But, there are more interesting opporturEties. For example, 
Ruby has proven quite useful for implementmg embedded domam 
specific languages (DSL), If you don't know what Tm talking about, 
check out Jim Freeze’s exceEent introduction at 
http://www.adima,com/mbycs/artides/mbyjasjdsLhtml. 

Basically, think of DSLs as nEni soiptmg languages tliat we 
build for very specific purposes. Ruby’s flexible syntax lets you 
create mini languages rliat appear very natural, but remains 
completely valid mby syntax — that means, you can execute diem 
directly as Ruby code, 

I am a big fan of DSLs in geneml, and Ruby-based DSLs in 
particaiiar. Now I can add them to my Objective-C projecLs. Tlial, 
alone, is worth tlie price of admission. 

And tliat’s only one example. As lime goes on, I'm sure we will 
find many amazing ways to cross-pollinate Ruby and Objective-C. 
After all, we kiven’t even talked about combining a RaEs 
application with Qx:oa or OSA, Tliere’s lx>iind to lie an inteiesting 
trick or two tliere. 

Yilii 
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Mac in the Shell 


by Edward Marczak 


name, there is a peirarmter list, which can be empty, 
ftmction would he called like this: 


This 


$ sum = ad d_em_up(9.B); 
print $sum: 


File Manipulation 
with PHP 


Naturally, this will output 'T7” To pass resiilLs hack from our 
function, they must be returned using the return ke>Tvord. 
PUP also supports piLssing by reference, a topic covered later. 
This raises an issue regarding scope, or, “"which variable are we 
talking about and where is it valid?” Take the code in listing 2. 



and other tips 



Introduction 

Wove been talking alTout PHP as a general scripting 
language, and how nice it is that it's standard issue on OS X, 
This makes life as a sysadmin a lor easier when rolling our 
scripts across many machines, even when they're a mix of say, 
103, 10.5j and even Linux and FreeBSD! Topics so far have 
covered the general language and database access, lliis 
month, well visit file manipulation and talk alxjui ways tt} keep 
growing scripts manageal’ile. 

BE-A-U-TI-FUL 

PHP has evolved from a hit of a rag-tag just-gei-it-clone 
language into a mature, mostly-objeet-oriented one. Even 
though version 5 l)rings stronger CX), you can stilE use it 
procedurally. At tile very least, you need to know^ about 
funcUofts, a feature lound in most languages. 

A Junction is a nearly independent subsec tion c)f a larger 
program. Most impcjrtantly, it lets a programiucT create a 
reusable bkxrk of code. This, in turn, reduces duplicate code, 
allows a problem to be [>roken down inicj smaller pieces and 
generally helps code "sell-documenD and remain manageable. 
Examples are always best. 

To create a function, you start wiih d function cleciamtion, 
and use curly braces to contain the function s code. Listing 1 
contains a very liasic sample fimerion. 

Listing 1: A sample function 

function add_em_up($a, $b) I 
$c ^ $a + $b: 
return $c; 

[ 


Listing 2 

01 $a - 5; 

02 

03 function set_a(^numberl I 
Oh $a “ Snumber; 

05 print $a."\n'': 

Ob 1 
07 

OB print 
09 set_a(42); 

10 print $a.'An": 


Fcjr those who haveriT seen this illustrated liefore, W'e initially 
set ”$a” to S. l1ie first prim staiemeni - outside of the function 
“ verifies this l>y printing “57 Line 9 transfers execution to the 
seta fund ion, starting at line 3^ When the function set_a 
is called, “42’' is passed in as a pKinmeler, and assigned to 
$ number, in turn, $a is assigned to $ number - for illustrative 
purposes only - and then printed. Hi is reveals “42” as 
expected. Once complete, though, the iirogram is picked up 
from after the functiem call line 10. When tlie print .statement 
in line 10 prims the value of $a, “5” is once again printed. 
Wliat happened here? 

The t|uestion is one of scope, sometliing Mac in the Shell 
hasn't dealt with in the past in bash scripring, “Scope” simply 
refers to wliere a varial^le is valid, or, its context. Functions 
create their ow’n heal scope. Tlierei:V)re, the “$a” variable 
defined inside of the “seLa” function is a dllTerent variable 
than the one used outside of the function, llie code in listing 
2 should illustrate that quite clearly. What if we do want Lo 
update varial>les outside of a fLincti{)n? There are several 
approaches. 

'fhe ea,siest way to get a value out of n I unction is to use 
tile return keyword, a.s seen in listing L When calling the 
function, it will he the right hand side of an assignment. Again, 
to call the function in listing 1^ you would use: 

$suin = add_e!n_up (9. S) ; 


What is tliere to immediately learn about this sample? First, a 
function name follows the same conventions as other labels in 
PHP. Namely, it stans widi a leuer or underscore, followed by 
any number of letters, numbers^ or underscores. Following the 


and the returned value would be assigned to the variable $sum 
Another w'ay of handling this is via the global keyword. 
By declaring a variable glolial within a function, all references 
to that variable will be made to the global version. Listing 3 
contains an example. 
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Seconds] 



135 


1024MB 2048MB 3072MB 4096MB 

(2x512) (2x1024) (1024+2048) (2x2048) 

Less seconds here means more time for something else! 


Faster Mac 


Adding more memory to your Mac® is fast, easy 
and inexpensive. And the difference this extra 
memory makes is AMAZING! Your applications 
and operating system run faster and more 
efficiently. With more memory, the only likely 
time you’ll ever see a "spinning beach bail" is at 
the beach because you've gotten your work done 
faster! 

Visit www.owcmac.com/memory - where 
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Listing 3 

$grai]d_total = 0: 

function coinpute_totalst) i 
global $grand_totalr 
$base “ read_values0: 

$graiid_total ^ $base + {$bane ‘ 0.75): 

3 

CQnipute_totals () ; 
print $grand_total., : 

As you may have guessed in reading listing 3, if $base 
turns out to be 100, the final print statement will actuary print 
**7500" despite Sgrandjotal being referenced outside of the 
function that assigned it. Ifs possible to declare as many 
variables as you like as global to a function. This is one way to 
manipulate multiple variables from within a function. 

Anotlter way to alter tlie value of several variables external 
to a function is passing hy rejetvnce. Simply, by default, tlie 
value of a variable is passed in to a function, and not the 
variable itself. What is a variable? Ifs just a location in memory^. 
Passing by reference actually passes a reference to tlie memc^ry 
location of tlie variable, rather than the value of the variable. 
An example should make this easier to understand than an 
explanation. Listing 4 illustrates. 

Listing 4 

= 1 : 

$b = 2i 

function swap_them{&$numl. &$num2) 1 


$tenip=$numl; 

$nuiiLl=$iium2: 
$ntan2"$temp; 

1 

swap_thera($a*$b): 
print 

print "$bVn**: 


In the swap_them() function, tlie variables $numl and 
$num2 point to the same memory location as the variables you 
pass in, meaning, altering $auinl and $num2 w\\[ alter the 
original variable also. Prepending an ampersand to the 
argument in the function definition with an ampersand causes 
that argument to passed by reference. Running the code in 
listing 4 results in printing: 

2 

1 

In other words, the variables get swapped, no returns or glohals 
needed. 

Manipulating Files 

Now that you know' how' to create larger, well-formed 
programs, we can pick up wliere last month left us hanging. 
Namely, dealing with files in a more direct w'ay. Last montli’s 
sample created a CSV file from data read out of a daiabasc, 
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However^ the solution was half-baked: spit the data to standard 
out and let the user redirect in the shell. Not rerrible, but we 
can certainly be nicer to die user. 

PHP has built-in functions tliat allow file access and 
manipulation. Let's look at the basics first. 

Before any access^ a file must be opened using the f open 
function, f open takes at minimum two parameters: the file and 
the mode. The fiJe parameter Is interesting as weVe in an 
environment where everything is a file. So, the file that you pass 
in can be a simple on-disk filename like “accounts.txt" It can 
also t>e a file descriptor like **php://5tdout". Perhaps mast 
interesting is the use of a llRfi such as 
"ftp://pubIic,example.com” or '‘http://^ tvw, example.com" We 
w'ill only cover the first two types in tliis article. 

Tlie second parameter is the open mode. The mode 
parameter specifies the type of access the program needs to the 
resource. The following labk summarizes die modes available; 

mode Description 

y open for reading only; place the file pointer at the 
beginning of the file. 

'r+ ' Open for reading and writing; place the file pointer 
at the lieginning of the file. 

'w' Open for writing only; place the file pointer at the 
beginning of the file and truncate the file to zero 
length. If the file does not exist, attempt to create it. 
Open for reading and writing; place the file pointer 
at the beginning of the file and tnincate the file to 
zero length. If the file does nor exist, attempt to 
create k. 

VT Open for writing only; place tlie file pointer at the 
end of the file. If the file does not exist, attempt to 
create it. 

'ay Open for reading and writing; [ilace tlie file pointer 
at the end of die file. If the file does not exist, 
attempt to create it. 

'x' Create and open for writing only; place the file 

pointer at the beginning of the file. If the file already 
exists, the fopenO call will fail by returning FALSE 
and generating an error. If die file does not exist, 
attempt to create it. 

\ry Create and open for reading and writing; place the 
file pointer at the beginning of the file. If the file 
already exists, the fopenO call w'ill fail by returning 
FALSE and generating an error. If die file does not 
exist, altempl to create it. 

Any of the modes listed may also be supplanted with a 'b' 
as the last character of the meuie panimeter. This designates 
binary mode, and no text or line-ending tran-slations will take 
place. It is highly recommended that this mode always be 
used. 

After a successful fopen, a file can be read using 
fgets()i fread() or file(). Each must be passed the 
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valid file handle resource obtained From f open. A file open for 
writing can be written to using the fwrite () function, which 
also must be passed a valid handle created by an fopen () call. 
Seeing tliis all put together will serve us best. 

First create a dummy configuration file and save it in top 
level of your home directory, named "fftest.rc" (nc^te die leading 
dot). Make its contents as follows: 

daemon=l 

send_iiiail=l 

ve]:bi:3se=Cl 

Listing 5 will demonstrate both read and write functions. 

Listing 5 

Oi <?pbp 

02 $liaTT,dle = open (getenv ( "HOME" ).'^/ . f test. rc. “r") ; 

03 If (Shandle) \ 

04 while (1feof(^handle)) I 
05 Sbuffer = fsetsf$handle. 4096): 

06 $paraTi3s “ e3splode{'*°" t$'buffer); 

07 Of lags [trim($para]iis tO]) ] =trim(Oparatiis fl]): 

OS [ 

09 fclose($harLdle) : 

10 printer($flags): 

11 J else I 

12 Satdert = fopen(‘php://atderr'. 'w'); 

13 fwrite ($stderr *'^There was an ErrorVn"): 

14 fclose($stderr); 

15 i 

16 7> 


Three new tilings are introduced on line 2: the f open () 
call, the at-sign C@”) and the getenv() calf The fopen () 
call is as discussed - pass in a file and mode. The at-sign in 
PUP is used to suppress error messages from printing. We can 
do that in this case as we're testing for success on the next line. 
Finally, getenv( > fetches an environment variable. 

line 4 starts a while loop that runs until end of file is 
detected with the f eof () function. Tlien, on line 5, one full 
line - up to 4,096 characters - are read from the file into the 
variable $buffer using the fgets( ) call. 

Line 9 closes ilie file and line 10 prints out the entire array. 
Since weTe not redirecting this output in any way, PHP will just 
print as usual: to stdout. 

line 12 begins the else sequence - if something is wrong 
with opening the conFig file. The variable $stderr is a new 
handle that references stderr. iwrite is used to send the 
message via stderr, followed by a call to close that resource. 

This gives yt^u an example of how to handle file input and 
output, and how^ to read or write to any of the standard file 
descriptors: stdin* stdout and stderr. If the code in listing 5 is 
run from the command line as such: 

php ftest*php > flags.txt 

The output from the prinLr statement will be redirected into 
the "fiags.txt” file. Fhe ^rroy statement, however, if invoked, w ill 
still print to the console, as w'e haven't redirected stderr. 
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Summary 

In total, we’ve learned the foundations of PHP, flow 
control, database access, functions and file manipulation. This 
alone allows a lot of flexibility and incredible utility. The 
database access alone makes it a better fit for certain situations 
over bash scripting. Next month will wrap up this short series 
on PHF as a general scripting language. Well touch on some 
of tlie small, but significant pieces weVe left out tlius far, and 
ways to reach into OS X. 

Media of the mondi: don’t let me hold you up..,you 
should probably be reading all of the iPhone SDK 
documentation you can get your hands on at this point! 

Next month Is WWDC, where 1 treasure the opportunity to 
meet everyone in the community face-lo-face. Until then, keep 
up the scripting! 

Jill 
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The Road To Certification: 
Part 5: ACSA and ACTC 

Increase your knowledge 
and build credibility on the way 


Introduction 

In this series of articles, we have looked at Apple’s IT 
certifications and hardware certifications. We examined reasons 
for, and ]’)enefits of, gening certified, as well as the testing 
experience and tlie changes Apple made to its IT certifications 
with the release of Mac OS X Leopard, and tlieir new Macintosh 
Technician certification, wliich qualifies a technician to perform 
warranty repairs while working at Apple Authorized Service 
Prcjviders, We also looked at Apple’s Pro Apps certifications for 
applications like Final Cut Pro and Logic Pro, In this final article 
in the series, we will review^ the requirements for the new 
Apple Cenified System Administrator (ACSA) 10-5 certification. 
We look at an over\aew of the topics covered on each of the 
exams required for ACSA certification, and what resources are 
available to help you prepare. Those resources of course w'ill 
include Apple Authorized Training Center classes and books. 
We will also discuss how to become an Apple Certified Trainer 
for IT courses, 

Apple Certified System 
Administrator 

Apple Certified System Administrator (ACSA) is Apple's 
highest I'f certification. An ACSA is someone who has an in- 
depth knowledge of Mac OS X's technical architecture and can 
design and maintain networks. They should be al’>le to enable, 
customize, rune and integrate Mac OS X, Mac OS X Server and 
other Apple teclinologies w-ithin a multi-platfonn environment. 
ACSA certification has undergone a few changes over the years. 
When the certification first launched for Mac OS X iO.2, it 
required two exams that were based on concepts covered in 
two five-day c!as,ses - one Ibcused on client and one on server 
With Tiger (Mac OS X 10.4) it became a credit-based system 
witli a mlnirnum of 7 current credits required to he an ACSA, 




by Doug Hanley 




Now with Leopard, there lia.s been a change that 1 believe Ls for 
the better. To achieve ACSA on Mac OS X 10,5 you now need 
to pass four tests: Ser\Tr Bsentials, Directory Services, 
Deployment, and Advanced System Administratit>n. 

Preparing for the Exams 

The best way to prepare for any of the xACSA exams is to 
take the associated class at an Apple Authorized Training 
Center (AATC), You can find the nearest AATC at: 
htlp://troining.apple.com/locations. You could also prepare by 
reviewing the Apple Training Series book published by 
Peachpit for the particular course, but you will be more 
thoroughly prepared by participating in a class. The classes are 
a combination of lectures and hands-on exercises designed to 
reinforce the concepts covered in the course. 

Directory Services 

In January's is.sue, w^e discu.ssed in detail what is involved 
in the Server Essentials course. Now we will look at the otlier 
three areas of study: Directory Services, DeploymenL and 
Advanced System Administration- 

In the four-day Directory Services course, you will learn 
how to effectively configure Mac OS X computers to access 
directory service.s, and how to configure Mac OS X xSeiwer to 
provide directory services in a mixed-platform environment. 
The course it,self will focus on both Mac OS X as a directory^ 
service client, and Mac OS X Setv'er as a directory server. Cross 
platform solutions will he emphasized in both instances. 
Students using Mac OS X will learn how to use network 
accounts and Kerberos autlientication with any common 
directory service, such as Apple’s Open Directory, Microsoft’s 
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Active Directory, or an industry-stanciard LDAP server. In 
working with Mac OS X Serv'er, students will leam how to run 
a robust, scalable directory system using Apple’s Open 
Directory service. Students will also learn how to use Mac OS 
X Server to augment an existing directory service infrastructure. 

Having a solid understanding of directory services and 
how they are implemented and integrated in Mac OS X is 
crucial in deploying multiple servers offering varying services 
all tied to die same directory structure. You will want this 
deeper understanding if you want to move beyond single stand¬ 
alone de[Dloyments of Mac OS X Server. 

Deployment 

Speaking of Deployment, diere has to be a l>etier way to 
install the operating system and software on multiple machine.s 
on your network than using a DVD cjr CD, righL? Well that is 
w'hat is covered in the three-day Mac OS X Deployment course. 
The first section of Deployment focuses on solutions for 
deploying software, ranging from individual files to complete 
system images to multiple machines. Students in this course will 
get hands-on experience use ttx^ils such as Apple Remote 
Desktop, Disk Utility, PackageMaker, and System Image Utility* 
You will learn the pro.s and cons of variou.5 deployment 
solutions. In the second section of the course, students will 
apply what they have just learned to create a full deployment 
plan that includes testing, deployment, auditing, and 
maintenance. You will also learn to create a multi-tiered 
Softw'are Update Server and durd party solutions wall l.>e 
discussed to augment your deployment plan. 


Advanced System Administration 

The Mac OS X Advanced System AdminisHation course will 
build on the foundations established in the Suppoit Essentials and 
Server Essentials couises and is designed to empower students to 
meet the challenges faced by administrators deploying Mac OS X 
Server in today's complex and dynamic data centers. This 
ciiallenging course will lx; five days in lengtli and provide in-depth 
and practical skills in Mac OS X technology. The cx>yrse's task-based 
locus enhances the learning process through the use of practical 
examples in a relevant context. 

Tliese tasks are organized into several key knowledge 
domains: implementation, networking, administration, and 
optimization* ImplemenLation tasks ftxnjs on those aspects of 
installing, upgrading, ctinfiguring, and migrating existing legacy 
systems to more recent versions and cxjnligurations. Networking 
tasks cc^ncentrate on establishing solid foundations k>r network 
services, as well as connecting private and public networks 
secuiely Students will gain experience wath monitoring tcx>ls and 
automation technologies tliat fonn the core of the administration 
tasks necessary to effectively administer larger deployments on a 
daily basis. An exploration of tcK>Ls and techniques relating to 
such performance-based tasks os optimizing services, scaling 
systems, and establishing high availability of services, data, and 
components, will help build students' confidence in their 
administration skills* 'fhe course concludes with the vital 
iTiaintenance tasks that address those aspects of maintaining a 
system's avaUabiliy and preserving tlie integrity of critical data* 
[Extensive use of die command line imerface rev'eals a deeper 
saipe of the course's subject material tind prepares students to 
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become more effective and efficient by taking advantage t>i‘ die 
wide variety of automation tedinologies liuilt into Mac OS X and 
Mac OS X Server. 

When Can I Start? 

Tliese last tliree courses and their accompanying lxK:>ks aie 
being developed at tliis time. Tliey are expected to be available 
witli their tests by mid 2008* Kevin White, who wTOte 5uppr>rt 
Essentials 10*5 is WTiting the Peachpit bcxjk for Deploytnent, Arek 
Dreyer is writing the Diredory Services bcxik, and Mac Tech 
Magazine's own Ed Maiczak is feverishly wmting the Advance 
System Administration book. More infcsmxition about the ACSA 
certification, classes and other preparatory materials is available on 
Apple's training website: 

http://lrain i ng .apple .com/certificarion/ocso 
Again, I strongly recommend taking the course at an AATC wiiere 
you not only get die hands-on experience, access to die IxkdI^s, but 
also the expertise of a trainer and otlier peers taking the course. 
The best trainers are die ones who acmally do diis type of 
integration in real world. As you look Ibr a trainer and training 
center dds waiuld be gcxxl criteria in clKX)S!ng your training 
experience. 


experience, and be sponsored by an AATC. That means die AATC 
vouches for your experience and is willing to use you as a trainer 
to deliver the course for %vhich you want to become certified. As 
part of die ACT application, you w ill lie asked to provide references 
for your teaching/training experience. 

You need to obtain ACT certification for each cxiurse you wish 
to teach. To do so, you need to aaend die course as a student, pass 
the .student exam at or above the trainer cut score, and submit an 
ACT application for each course, indicating your sponsoring AATC* 
You will also have to participate in die course T3 (could be an 
instructor-led T3 class or one or more podcasts, depending on the 
course), and pass the trainer-level evaluation (quiz and interview) 
at the conclusion of the T3 class. When you complete all die 
requirements, you will receive an email from the ACT Program 
Manager with instmctions for accessing the tools and information 
available to ACTs* 

You can find more infomiation on the ACT program as well as 
an application at: http://training.apple.com/ad 
dills would be an excellent way to sliare the laiowledge you liave 
gained along die w^ay on your road to certfcttion, by helping 
otliers as well. 

The End Of The Road? 


Apple Certified Trainer 

Are you interested in becoming certified to deliver Apple’s 
curriailum? Well to become an IT Apple Certified Trainer (ACT), 
you must hold Apple Certified Technical Coordinator (ACTO 
certification, vl0,4 or higher, have two years of teaching or training 
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So as W7tf dmw^ to a conclusion to diis series of articles on 
Apple's certificadons we cannot really say tliiit we have reached die 
end of the rcjad. As long as there is another version of Mac OS X 
being developed, as long as there are new features lx*mg 
implemented, there will alwiiys lie more to learn about Apple's 
operating system and applicatioas, So in reality even if you achieve 
each and eveiy ceitificjiion Apple offers on a version of Mac OS X, 
there w^ill always lie a new version coming ju*st over the horizon to 
learn and gain certification. 

In diis series of articles w'c have looked at Apple’s three levels 
of rr Certifiaition, die Afijile Ortified Suppoit Professional, the 
Apfile Certified Technical Ccxirdiiiaror, and die Apple Certified 
System Administraton We liave looked at die Apple Certified 
Macintosh Technician, who is able to perfomi w’arranty repairs. 
Ajiple's Pro Certifications are for the various cTeative applications 
like Pinal Cut Pro and Logic Pro. Lastly we have looked at die Pro 
App :ind IT trainer cerrificatiotis as well. Hopefiidy we have 
provided you widi a more infonued padi on your road to being a 
certified professional. 

Certification Ls abcmi Iniving a metric diat m&isures your skills 
and knowledge. It is alxxit Ix-ing able to show youisell' and odiers 
you actually know^ and can operate at certain level in a technical 
field. St) I giv^ you this challenge to continue strive to liettcr 
yourself and you skills as part of the journey. , _ _ 

Ji\\ 
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Creating AppleScript applications using ASUnit 


Introduction 


i 


by Andy Sylvester 




In tlio fiiHi pun of this series^ t]ie concept of test-driven 
development was introduced, showing how to add functionality 
to an AppleScript applicalkm by writing tests first, then the 
program higic. The ASUnil testing framework was also 
demonstrated to slitm*^ how^ mulriple test scripts could he 
created to test application logic. In tlie second part of this series, 
a complete application will l:»e developed using test-driven 
techniques and the ASUnil testing framework. 

Creating the application 

To keep tilings simple, 1 am going tc: develop a ntimlier 
guessing game, W(j will write tests and use those tests to guide 
the design of tlie logic for [Ire application. Here is an initial list 
of “requirements'' for our game: 

lire applic'alkm wtl! pick a random number from 1 to lf)(J 
Players have to pick a nimtlxT lielween 1 and 100 
The application will tell the player if their guess is out fif range 
oT not an integer 

The application will tell the player if the number they pick is 
higher than the random nunil^r, lower than the random 
number, or the right number, 

When the player picks the right number, the application will 
ccjngraiulate the player and tell the player hew many 
guesses it tcxik to get the right answer. After that, the game 
ends. 

We could add more requirements for cur game, liut tliis is 
enough to define a complete application. In tlic first part of this 
,series, we presented the fcdlowing steps for test-driven 
development: 

Write some test code 

Rim the test and see that it fails 

Write tile source code that implements the feature for the 
rest 


Run the test again and see that it passes 
Refactor or clean up source code 

To begin, we will write several tests, ftK'using on the 
number that the [>layer cIkkiscs (needs to be lietween 1 and 100 
inclusive). Listing 1 shows tlie llrst test script: 

property parent : load script file "> 

((“Sylvester HD:LibraryiScripts:”) i “ASUnit,sept") 

property suite : makeTestSultet"My Guessing Game Tests“) 

script |GuessingTestsI 

property parent : registerFixturetme) 

on settIpU 
end BetUp 

script |Guess0ut0fRangeH1gh| 

property parent : registerTestCase(me) 

set testGuees to TestGueSBingGame's GetNewGuessO 

should(testGuess 1b greater than 100, ^ 

“tesLGueas is too hight 
end script 

script IGuessOutOfRan geLow| 

property parent : registerTestCase(me) 

set testGuess to TestGuessingGame's GeLNewGueasO 

should(testGuess is less than 1, ^ 

“testGuess is too low!") 
end script 

script iGuessIsNotAnlntegerI 

property parent : registerTestCase(me) 
set testGuess to TestGuessingGame's GetNewGuess() 
set checkTestGuess to irt(testGuess) 
should(testGuess is equal to checkTestGuess, ^ 
"testGueBS is not an Integer!'*) 
end script 
end script 

run makeTextTestRunner(suite) 

Running these tests give the following results: 

My Guessing Game Tests 

GiiessingTests - GuessOutOfRangeHigh *., ERROR 
GuessingTesta - GuessOutOfRangeLow ERROR 
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GuessingTests - GuessIsNotAnlntegsr ... ERROR 
ERRORS 


test: GuessingTests - GuessOutOfRangeHigh 

message: The variable TestGuessingGame is not defined, (- 

2753) 


test: GuessingTests - GuessOutOfRangeLo-w 

message: The variable TestGuessingGame is not defined. (- 

2753) 


test: GuessingTests - GuessIsMotAnlnteger 

message: The variable TestGuessingGame Is not defined. (■ 

2753) 


Ran 3 tests in 1 seconds, passed: 0 skips: 0 errors: 3 
failures: 0 

FAILED 

This completcf.s the second step (watching the tests hiil). 
Next, we need to create some application logic so that the rests 
pass. The tests imply that there is a class called GnessingGame, 
and that it has a method, GetNewGuess, that returns a number. 
Since we do not have a user interface yet, we will create another 
methcxi (SetNewGuess) to set the value of the guess . Using 
the class we developed earlier as a guide, we can create 
Giie,ssingGanie.scpt as followLS: 

script DuessingGame 

- GuessIngGame has one property, the newest guess from 
the player. 

property newGsiesa : O.t) 

- Sets the newGuess property to the value passed to it. 
on SetNewGuess{theGuess) 

set newOuess to theGuess 
end SetDay 
on GetNewGuessO 
return newGuess 
end GetHewGuesa 
end script 

Now iJiat wc have a cla.ss, we w ill modify the test script to 
reference the GuessingGame script, use the setUp function to 
initialiEe a copy of the class for our tests, and add a property 
object for testing, lasting 2 shews the updates: 

property parent : load script file i 

(("Sylvester HD:Library:Scripts:") & “ASUnit.sept”) 
property lib : load script file “> 

{("Sylvester HD:Test:") h "GuessingGame,sept") 

property suite : jnakeTestSuite["My Guessing Game TeEts”) 

script IGuessingTestsI 

property parent : registerFixture(tne) 

property TestGuessingGame : missing value 

on setup{) 

copy lib's GuessingGame to TestGuessingGame 
tell TestGuessingGame to SetNewGuess{101) 
end setUp 

script |GuessQutOfRangeHighI 

property parent : registerTestCase(me) 

set testGuess to TestGuessingGame's GetNewGuess(} 

should(testGuess Is greater than 100. "> 

“testGuess is too hlght"") 


end script 

script |GuessOutOfEangeLow| 

property parent : registerTestCase(me) 
set testGuess to TestGuessingGame *e GetMewGuess() 
should (testGuess is less than 1, “f 
"testGuess is too lowl") 
end script 

script |GuessIsMotAnluteger I 

property parent : registerTestCaseCme) 
set testGuess to TestGuessingGame's GetNewGuess[) 
set checkTestGuess to int(testGuess) 
shouldCtestGuess is equal to checkTestGuess, “> 
"testGuess is not an integer!") 
end script 
end script 

run makeTejttTestRunner (suite} 

Let's see how our tests are doing now: 

My Guessing Game Tests 

GuessingTests ' GuessGutOfRangeHlgh .,, ok 
GuessingTests ■ GuessOutOfRangeLow ... FAIL 
GuessingTests - GuesslsMotAnlnteger .., ERROR 

ERRORS 


nest: GuessingTests - GuessIsNgtAnlnteger 

message: ^script |GuesslsMotAnlnteger|fl doesn't understand 

the int message. (-1708) 


FAILURES 


test: GuessingTests ■ GuessOutOfRangeLow 
message: testGuess is too low I 


Ran 3 tests in 0 seconds, passed: 1 skips: 0 errors: 1 
failures: 1 

FAILED 

The GuessOutOfRang,eHigh tcKl passed, but we 
initialized the value of the guess to 101, ^^o that test should have 
failed. The GuessOutOfRangeLow failed, which shouldn't 
happen, since the niirril)er was greater than 1 (it should have 
passed!). Finally, the GuessIsNotAnIntegei: had an error 
(script IGuessIsNotAnInteger I £ doesn't 
understand the int message). There must be .some 
problem in how the "int" function is l^eing used. Let’s use tliese 
resLilts to improve our tests and mayfTe our code as well. 

UTien using the should statement in a test, the test fails if the 
first argument or cc^ndition is not tnae. In the 
GuessOutOfRangeHigh test, the condition is tnie (TOl is greater 
iluin too), l7ut the title of the test suggests it should fail if 
testGuess is greater than KX), Lefs tiy^ changing the condition to 
read “testGuess is less than 101^ so that if testGuess 
is greater than 100, the test will fail. Looking at the 
GuessOutOfRangeLow, the condtion is false, but tiie number is 
actually not too low. As in the GuessOutOfRangeHigh test, we 
should change tlie test condition to match up l>5rter witli tlie title 
of the test. Lefs try changing the condition to read “testGuess is 
greater than 0”, so tliat if the value of testGuess is less tiian 
1, the test will fail. We will leave tlie last test as it Is and try to fix it 
in the next pass. Listing 3 shows die updates: 
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property parent : load script file “i 

(("Sylvester HD:Library:Scripts : ■') 6t "ASUnit. sept 
property lib ; load script file ({"Sylvester HD:Test:”) & 
"Guessin^Game .sept"') 

property suite : makeTestSuite(“My Guessing Game Tests“) 

script |GueafiingTestsI 

property parent : registerFlxturefiae) 

property TestGuessingGame : missing value 

on setUpO 

copy lib's GuessingGame to TestGuessingGame 
tell TestGuessingGame to SetKewGuess(101} 
end setup 

script |GuessOutOfRangeHigh| 

property parent : registerTeatCase(me) 

set testGuess to TestGuessingGaine's GetNewGuessO 

should (testGuess Is less than 101. 

“testGueas is too high!”) 
end script 

script |GuessOLitOfRangeLow| 

property parent : reglBterTestCase(me) 

set testGuess to TestGuessingGarae*s GetNewGuess() 

should (testGuess is greater than 0. “> 

“testGuess is too 1 o\jI“J 
end script 

script iGuessIsNotAnlriteger I 

property parent : registerTestCase(me) 
set testGuess to TestGuessingGame's GetNewGuess() 
set checkTestGuess to int(testGuess) 
should{testGuess is equal to checkTestGuess. ^ 
"testGuess is not an integer!") 
end script 
end script 


run makeTextTestRunner(suite) 

When we mn the tests again, we get the following results: 

My Guessing Game Tests 

Guessinglesta - GuessOutOfRangeHigh ... FAIL 
GuessingTests - GuessOutOfRangeLow ,,. ok 
GuessingTests - GuessIsNotAnlnteger ... ERROR 

ERRORS 


test: GuessingTests - GuesalsNotAnInteger 

message: ^script |GuessIsNotAnInteger|E doesn't understand 

the int message. (-1703) 


FAILURES 


test: GuessingTests ^ GuessOutOfRangeHigh 
message: testGuess Is too high! 


Ran 3 tests in 0 seconds, passed: 1 skips: 0 errors: 1 
failures; I 

FAILED 

Now tlio first two tests respond as we expect. The value of 
testGuess is too high, so that te.st should falL It is not too low; 
so that test passed. Now; lets see if w'e can figure out what the 
proLilem is wath tlie third test. In AppleScript, die as keyw'ord is 
used for coercion of a paranietcr to another type. We wall 
replace the coercion line in the GuessIsNot An Integer lest 
with tile follow ing: 
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set checkTestGuess to testGuess 
checkTestGuess as integer 

With tliese chiinges, we get the following results: 

My Guessing Game Tests 

GuessingTests - GuessOutOfRangeHigh ,,. FAIL 
GuessingTests - GuessOutOfRangeLow .., ok 
GuessingTests GuesslsNotAuInteger .-. ok 

FAILURES 


test: GuessingTests * GuessOutOfRangeHigh 
Tnessage: testGtiess is too high! 


Ran 3 tests in 1 seconds, passed: 2 skips: 0 errors: 0 
failures: 1 

FAILED 

Now that tile tests are working as expected, let’s flesh out 
tile logic in our class functions. To start, we will create a function 
to check die value of die number and create a text response. 
Listing 4 shows the updates to GiiessingGame.scpt: 

script GuessitigGaDte 

property newGuess : 0*0 
property checkTestGuess : 0 
property gueasResponse : "'test" 
property rangeResponse : "test" 

Sets the newGuess property to the value passed to it. 


on SetNewGuess(theGuessJ 

set newGuess to theGuess 
end SetNewGuess 
on GetNewGuess() 

set guessResponse to CheckGueaECases() 
return guessResponse 
end GetNewGuess 
on CheckGuessCasesO 

if newGuess is greater than 100 then 
set rangeResponse to "■ 

''Your guess is too high! Pick a numher from 1 to 

100 ." 

end if 

if newGuess is less than I then 
set rangeResponse to ^ 

"Your guess is too LovE Pick a number from 1 to 

100 ." 

end if 

set checkTestGuess to newGuess 
checkTearGuess as integer 

if checkTestGueas is not equal to newGuess then 
set rangeResponse to 

"Your guess is not an integer! Pick a number 
from I to 100." 
end if 

return rangeResponse 
end CheckGuessCases 
end script 

After making updates to GuessingGame^scpl, you wdll need 
to quit Script Editor and start it again for the changes to take 
effect, Running the tests give the follow^ing results; 

My Guessing Game Tests 
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Guessin^Tefits - GueEsOutOfRangeHigh ... FAIL 
■GuessingTests - GuessOutOfRangeLow ... ok 
GuessingTests - GuessIsNotAnInteger ... ERROR 

ERRORS 


test: GuessingTests - GuessIsNotAnInteger 

message: Can't make ''Your guess is too high I Pick a numher 

from 1 to 100.'* into type integer. (-1700) 


FAILURES 


test: GueaslogTestE - GuessOutOfRaugeHlgh 
message: testGuess is too high! 


Ran 3 tests In 0 seconds. passed: I skips; 0 errors: 1 
failures: 1 

FAILED 

Now that the class functions return a text response, we 
need Co update the tests to check for that response. Actually, we 
want the tests to check to make sure that we did not ^et any of 
the error responses from GetNewGuess. If we get one of those 
responses, w^e know we will have a test failure. Listing 5 shows 
the test updates: 

property parent : load script file “* 

((’’Sylvester HDrLibraryiScripts ^ "AEUnit,sept*’) 
property lib : load script file [("Sylvester HD:Test:") fii 
"GuessingGame.sept"} 

property suite : raakeTe£tSijite(”My Guessing Game Tests") 

script IGuessingTeEtaI 

property parent : registerFixture{ine] 

property TestGuessingGame : missing value 


on setUpO 

copy lib's GuessingGame to TestGuessingGame 
tell TestGuessingGame to SetNewGuess(101] 
end setup 

script I Gue. s s Out 0 fRatigeHl gh | 

property parent : registetTestCaseCme) 

set testGuess to TestGuessingGame's GetNewGuessO 

should (teatGuess is not equal to 

"Your guess is too high! Pick a number from 1 to 

100/'.^ 

"testGuess is too high!") 
end script 

sc ript IGuessOutOfRangeLow| 

property parent : registerTestCase (me) 

set testGuess to TestGuessingGame's GetNewGuessO 

should (testGuess is not equal to “> 

"Your guess Is too low! Pick a number from 1 to 

100 .\ ^ 

"testGuess is too low!") 
end script 

script iGuessIsHotAnlntegerI 

property parent : registerTestCase(me) 

set testGuess to TestGuessingGame's GetNewGuess() 

should (testGuess is not equal to “> 

"Your guess is not an integer I Pick a number from 
1 to 10D,”,-i 

"testGuess is not an integer!") 
end script 
end script 

run niakeTextTestRunner(suite) 

Wc will now run n set of tests for each failure condition, and 
a test w'here the value of newGuess is within range. In the 
setup scTipt set the rest value to lOI. Running the tests gives 
the following results: 

My Guessing Game Tests 
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GuessingTests - GuessOutOfRangeHigh ... FAIL 
GuessingTests - GuessOutOfRangeLow ... ok 
GuesaingTests - GuessIsNotAnlnteger ... ok 

FAILURES 


test: GueasingTests - GueasOutOfRangeHlgh 
message: testGuess is too high! 


Ran 3 tests in 1 seconds, passed: 2 skips: 0 errors: 0 
failures: 1 

FAILED 

The Guess Out Of Ran geHigh test failed as expected. 
Now, set the test value to 0. You should then see the following 
test results: 

My Guessing Game. Tests 

GuessingTests - GuessOutOfRangeHigh ,,. ok 
GuessingTesta ‘ GueSEOutOfRangeLow ._. FAIL 
GueasingTeats - GuesalsMotAnlnteger ... ok 

FAILURES 


test: GuesaingTests ’ GneasOutOfRangeLow 
itieaEage: testGueas is too low! 


Han 3 tests in 0 seconds, passedt 2 skips: 0 errors: D 
faiiures: 1 

FAILED 

Now, set tlie test value to Test", You .should then see the 
Ibliowing test results: 

My Guessing Game Tests 

GuessingTests - GuessOutOfRangeliigh ... ERROR 
GueasingTests * GueaaOutOfRangeLow ... ERROR 
GueasingTests - GuessIsMutAnlnteger ... ERROR 

ERRORS 


test: GueasingTeats - GuessOutOfRangeHigh 

message: Can't make ''test'' into type Integer. (-17D0) 


test; GueasingTests ’ GueaaOutOfRarigeLDW 

message: Can't make “teat" into type integer. (-1700] 


test; GuessingTests - GuesalsHotAnInteger 

message: Can't make "test" into type integer. ( 170D] 


Ran 3 testa in 1 seconds, passed: 0 skips: 0 errors: 3 
failures: 0 

FAILED 

Oop.sl Looks like we have a problem,..whai .should we do? 
It looks like CheckGuessCases is not adequately checking for 
the case when the input is not an integer (in this ease, a .string). 
We Will restructure this function in GuessingGame.scpt to cheek 
for the data class of the input, and arrange the branching 
structure to stop as soon as the correct condition is detected. 
Also, w'e will add another branch to set rang^Response to a 
separate message if the number is in range. 


on CheckGueasCaEeE0 

set guessGlass to class of newGuess 
if guessClass is not equal to integer then 
set rangeResponse to 

"Your guess is not an integer! Pick a number 

from I to 100." 

else if newGuess is greater than 100 then 
set rangeResponse to 

"Your guess is too high I Pick a number from 1 

to too." 

else if newGuess is less than 1 then 
set rangeResponse to 

"Your guess is too low! Pick a number from 1 

to lOO." 

else 

set rangeResponse to "Guess is within range." 
end if 

return rangeResponse 
end CheckGuessCases 

Now, .set the te.st value to 'test” again. You should then see 
the following test results: 

My Guessing Game Tests 

GuesslngTests - GuessOutOfRangeHigh ... ok 
GuessingTests - GuessOutOfRangeLow .,. ok 
GuessingTests - GuessIsNotAnlnteger FAIL 

FAILURES 


test: GuesslngTests - GuessIsNotAnInteger 
message: testGuess is not an integer! 


Ran 3 tests in 0 seconds, passed: 2 skips: 0 errors: 0 
failures: 1 

FAILED 

'rhi.s gives tlie failure aisponse that we expect. Since we had a 
test problem wtth the text entry, let’s try setiing the test v^ilue to a 
real number, like 30.7, Yju should ilieii get tlie following resulis: 
My Guessing Game Tests 

GueasingTests - GuessOutOfRangeHigh ,., ok 
GuesslngTests - GuessOutOfRangeLow ... ok 
GuessingTests - GuessIsNotAnlnteget FAIL 

FAILURES 


test: GuesslngTests - GuessIsNotAnlnteger 
message: testGuess is not an integer! 


Ran 3 tests in 0 seconds, passed: 2 skips; 0 errors: 0 
failures: L 

FAILED 

Again, this Ls the expected response. Now^ for the final test, 
an integer value between 1 and 100 (let’s say 51). Our results 
are: 

My Guessing Game Tests 

GuessingTestS - GuessOutOfRangeHigh ... ok 
GuessingTests ■ GuessOutOfRangeLow ... ok 
GueasingTests - GuessIsNotAnlnteger ... ok 

Ran 3 tests in 0 seconds, pasaed; 3 skips: 0 errors: 0 
failures: 0 
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OK 

Finiilly, hack to where we want to be-all tests passing with 
proper inputs, and all tests tailing when the conditions tor the 
test failures are met. 

Now, let's start work on the user interface by modifying 
SetNewGuess in GuessingGame.scpt to display a dialog box 
and ask the user for a valuer 


on SetNewCuess (theG-uess) 

set newGuess to text returned of 
[display dialog “Pick a number from 1 to lOO" 
default answer 
end SetNevGuess 

This will prompt the user for an input for each of the tliree 
tests we have written. When we run the tests with an input of 
''8’', we get the following resufts; 

My Guessing Game Teats 

GuessingTests - GuessOutOfRangeHlgh ,,. ok 
GuessingTests - GuessOutOfRangeLow ... ok 
GuessingTests GuessIsWotAnInteger ... FAIL 

FAILURES 


test; GuesslngTests - GuessIsNotAnlnteger 
tnessage: teatGuess is not an integer! 


Ran 3 tests in 7 seconds, passed: 2 skips: 0 errors; 0 
failures: 1 

FAILED 

It looks like tfie code in CheckGuessCases is not 
detecting that the input is an integer. We will add a line to this 
script in GuessingGame.scpt to check what the class of our 
input is: 


on CheckGueseCases() 

set guessClass to class of newGuess 
display dialog “guessClass is " "> 

guessCXass - this is the new line 

When we repeal the tests, the dialog box showed 
“guessClass is Unicode text” It lotaks like w^e need 
more logic to force the input to be a number and to keep tfie 
range tests iTom failing. Let’s try restrucniring the logic for 
CheckGuessCasee again in GuessingGame.scpr to catch the 
‘'not an integer" error: 

on GhcckGuessGases() 
try 

set checkNewGuess to newGuess as number 
if checkNewGuess is greater than 100 then 
set rangeResponse to ^ 

“Your guess is too high! Pick a number 

from 1 to 100.” 

else if checkWewGuess is less than 1 then 
set rangeResponse to 
“Your guess is to.a low! Pick a number 

from 1 to 100.” 

else 

set rangeResponse to “Guess is within 

range 

end if 
on error 

set rangeResponse to ^ 

“Your guess is not an integer! Pick a number 

ma:iicii 
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front 1 to 100. 

end try 

return rangeResponse 
end CheckGuessCase^ 


We also need to add a property for the checkNewGness 
parameter to the GiiessingGame script: 

property cbeckNewGoees : 0 

When we repeat the tests using the word “test" as tlie input 
in the dialog Itox, we get llie following response: 

My Guessing Game Tests 

GuessingTests - GueesOutOfRangeHlgh ... ok 
GusssingTests - GuessOutOfRangeLow ... ok 
GuessingTests - GuessTsMotAnluteger ... FAIL 

FAILURES 


test: GuessingTests - GuessIsNotAnInteger 
message: testGuess is not an Integer! 


Ran 3 tests In 13 seconds, passed: 2 skips: 0 errors: 0 
failures: 1 

FAILED 

Now^ llie re.structiired logic catcher the non-integer value 
and allows the other tests to pass. Next, we will add some logic 
to check to see if the guess by the player is above or below the 
random value. Following our tesKl riven development 
philosophy, we will create .seventi new tests in a new test file. 
Li.sting 6 shows tlie new tests: 

property parent : load script file "> 

(("Sylvester HD:Librnry:Scripts:& “ASUnit,sept") 
property lib ; load script file “i 

(("Sylvester HD:Test:”] £i "GiiessingGame.sept") 

property suite ; makeTestSultet"My Guessing GatiE Tests") 

script |MoreGuessitigTeBts| 

property parent : reglaterFixture(me} 

property TestGuessingGame : missing value 

on setUpO 

copy lib’s GuessingGame to TestGuessingGame 
end setup 

script IGuessIsHigherThanRandomNumber| 
property parent : registerTestCase(me) 
on setupC) 

copy lib's GuessingGame to TestGuesslngGame 
set TestGuessingGame'E testNumber to 40 
tell TeatGuessingGame to SstNewGuesst) 
end setup 

set testGuess to TestGueasingGame's GetNewGuessO 
set GuessIsHighOrLoV to TestGuesEiugGame"s 
CheckTheGnessf) 

should(GueasIsHighOrLow is not equal to “> 

"Your guess is too highl Pick a lower number.”, 
"guess is too high!") 
end script 

script iGuesElsLowerThatiRandomNumberl 

property parent : reglsterTestCase(Tne) 
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on setUpO 

copy lib's GuessingGams to TestGueseingGanie 
set TestGuessingGame‘s testNvunber to 40 
tell TestGuessingGame to SetNewGuess() 
end setup 

set testGuesa to TestGueBsingGame's GetNewGuesa() 
set GuessIsHigliOrLDif; to TestGuessingGame' s 
GheckTheGuess() 

should(GuessIsHighOrLov ia not equal to “> 

''Your guess is too low[ Pick a higher number. 
"guess is too lawl") 
end script 
end script 

run tnakeTextTestRunrier(suite) 

In these two tests, we have created testNumber to serve 
as the “random number’', then created a reference to a new 
function, GheckTheGuess, which will return a text string 
telling the user whether the guess is too high or too low. To 
make tile GuessingGame script consistent, we will delete the 
calling argumeni for SetNewGuess and add a property for 
testNumber. The updated version of GuessingGame.scpt is 
shown in Listing 7: 

script GuessingGame. 

property newGuess : 0,0 
property checkNewGuess : 0 
property testNuinber : 0 
property guessResponBe : ''test" 
property raogeResponse i "test" 

- Sets the newGuess property to the value passed to it, 
on SetWewGuessO 

set newGuess to text returned of ^ 

(display dialog "Pick a number from 1 to 100" default 
answer "") 

end SetNewGuess 
on GetNewGuessO 

set guessRespotise to CheckGuessCases() 
return gueasResponae 
end GetNewGuess 
on CheckGuessCases[) 
try 

set checkf^ewCuess to newGuess as number 
if checkNewGuess is greater than 100 then 
set rangeResponse to 

“Your guess Is too high! Pick a number from 1 

to lOO." 

else if checkNewGuess is less than 1 then 
set rangeResponse to 

"Your guess is too low! Pick a number from I 

to 100." 

else 

set rangeResponse to "Guess is within range," 
end if 
on error 

set tangeRespanse to “> 

"Your guess Is not an integer! Pick a number from 

1 to 100." 

end try 

return rangeResponse 
end CheckGuessCases 
end script 

When we run the tests with an input value of 8 for the 
user’s guess, we get the following results: 

Hy Guessing Game Tests 

MoreGuesaingTests - GuessIsHigherThanRandoraNumher ... ERROR 
MoreGuessingTests - GuessIsLowerThanRandomNumber ... ERROR 


ERRORS 


test: MoreGuessingTests - GuessIsHigherThanRandomNumber 
message: Qacrlpt:fe doesn’t understarid the GheckTheGuess 
message. (-1?08) 


test: MoreGuessingTests * GuessIsLowerThanRandomNumber 
message: ^scriptE doesn’t undferstand the CheckTheGuess 
message. (-1708) 


Ran 2 tests in 21 seconds, passed: 0 skips: 0 errors; 2 
failures: 0 

FAILED 

Now^ tliat we know tint the tests tail, we wtll create the 
CheckTheGuess Function and add this to GiiessingGame.scpt: 

on CheckTheGuess [) 

if checkNewGuess is less than testNumber then 
set checkResponse to "> 

“Your guess is too lowl Pick a higher number." 
else if checkNevGuess is greater than testNumber then 
set checkResponse to “i 

"Your guess is too high! Pick a lower number." 

else 

set checkResponse to "You picked the right 

number I" 

end if 

return checkResponse 
end CheckTheGuess 

Wc also need to add a property fcjr the checkResponse 
element to GuessingGame.scpt; 

property checkResponse : "test" 

Since we are setting testNumber lo 40 in each test, we 
will enter tlie wrt^ng input for the rwo new tests to see if we can 
detect a failure. When we input 60 for the 
GuessIsHigherThanRandomNumber test and 20 for the 
GuesslsLowerThanRandoiiiNumber test, we get the 
following resulLs: 

My Guessing Game Tests 

MoreGuessingTests - GuessIsBigherThanRandomNumber ... FAIL 
MoreGuessingTests CuessIsLowetThanRandoniNumber FAIL 

FAILURES 


test: MoreGuessingTests - GuessIsHigherThanRandomNumber 
message: guess is too high! 

test: MoreGuessingTests - GuesElsLowerThanRandomNumhet 
message: guess is too lowl 


Ran 2 tests In 4 seconds, passed: 0 skips: 0 errors: 0 
failures: 2 

FAILED 

Wc will now add a test for the condition where the user 
picks die riglit number: 

script IGuesslsGorrectI 

property parent ; registerTestCase(i]ie.] 
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on setup() 

copy lib's GuessingGanie to TestGuessin^Game 
set TestGuessingGaiiie*s testNumber tq 40 
tell TestGuesslngGame to SetWevGuessC) 
end setup 

set testGuess to TestGuessingGame^s GetNewGuessO 
set GuessIsHigbOrLow to TestGuesslngGaine's 
GheckTheGuess 0 

should (GuesslBHlghOrLow is equal to 

“You picked the right numberT'. "wrong guess!”) 
end script 

In this lest, we are checking the success ctmditiun tor when 
the guess is eorreci. When we run the tests as before and enter 
40 for aJI of the tests, we gel the Ff>llowing results: 

My GueEglng Game Tests 

HoreGuessingTests - GuessIsHlgherThanRandotiiNmnber ... ok 
HoreGuessingTests - GuessIfiLawerThanRandomHutnber ok 
MoreGuessingTesta ■ GuessTflCorrect ... ok 

Ran 1 testa in 4 seconds, passed: 3 skips: 0 errors: 0 
failures: 0 

OK 

If we use 45 for all the tests, we get die Following results: 

My Guessing Game Tests 

MoreGuesslngTests - GuesalsHigherThanEandoinNumber ... FAIL 
MoreGueasitigTests ■ GuessIsLowerThanRandomNumbar ... ok 
HoceGuEflsingTests ■ GuesalsCorrect ... FAIL 

FAILURES 


test: MoreGuessingTests * GuesalsEigherThanRandomHuoiber 
message: guess is too high! 


test: HoreGuessingTests - GuessIsCorrecT 
message: wrong guess! 


Ran 3 tests in 6 seconds, passed: 1 skips: 0 errors: 0 
failures: 2 

FAILED 

The results sliow that the guess is too high (45 > 40) and 
that it is the wrong number, so it looks like the tests are working. 

We will now develop the feature to keep track of how many 
gues.ses are made by die player. As iiefore, we .start the 
development cycle by adding a new test lo listing 6 above: 

script [GueBsCountlsGorrectI 

property parent : reglsterTestCase(me) 
on setUpO 

copy lib's GuessingGame to TestGuesslngGame 
set TestGuessingGame'S testNumber to 40 
tell TestGueaslngGame to SetNewGuess() 
end setUp 

— Do three guesses and check to see if guessCounter = 
3 

set testGuess to TestGuessingGame*s GetTSewGuess{) 
set GuessIsRighOrLow to TestGuessingGamE‘s 
CheckTheGuessO 

tell TesEGuessingGame to IncrementGuessCounter() 
set testGuess to TestGuessingGame’s GetNewGuesstJ 


set GuessIsHlghOrLow to TestGuessingGame's 
CheckThsGuess t) 

tell TestGuessingGame to IncrementGuessCounter() 
set testGuess to TestGuessingGame's GetMewGuessO 
set GuessIsHlghOrLow to TestGuessingGame's 
CheckTheGuess() 

tell TestGuessingGame to IncrementGueBsCounter[) 
set checkGuessCounter to TestGuessingGame's 
GetCounterValue() 

should[checkGuessGounter is equal to 3, "i 
"guessCounter has the wrong count!") 
end script 

When we run our tests using 40 as the input value, we get 
the fallowing results: 

My Guessing Game Tests 

MateGueSBlngTests ^ GueselsHlgherThanRandomNumber ,.. ok 
HoreCuesslngTests - GuessIsLowerThanRandomMumber ... ok 
MoreGuessingTests - GuessTsCorrect ... ok 
MoreGuessingTests ‘ GuessCountlsCorrect ... ERROR 

ERRORS 


test: MoreGuessingTests - GuesaCountlsCorrect 
message: ^scriptl doesn’t understand the 
tnCrementGuessCounter message. (*170S) 


Ran 4 tests in ID seconds, passed: 3 skips; D errors: I 
failures: 0 

FAILED 

Now we add some functions to the GuessingGame script 
to increment the counter and get the value of the counter. Also, 
we will add a new property variable called numberOfGuesses 
to collect how' many guesses the player makes. 

property numberOfGuesses ; 0 

on IncrementGuessCounter0 

set numberOfGuesses to numberOfGuesses + 1 
end IncrementGuessCounter 
on GetCounterValueO 

return numberOfGuesses 
end GetCounterValue 

Reptrating our previous tests (entering 4() for each te.st), we 
get the following results: 

Hy Guessing Game Teats 

MoreGuessingTests - GuesslsHlgherThanRandomMumber ... ok 
MoreGuesslngTests GuessIsLowerThanRandomNuraber ... ok 
MoreGuessingTests GuessIsCorrect ... ok 
MoreGuessingTests ' GuessCountlsCorrect ... ok 

Ran 4 tests in 6 seconds, passed: 4 skips: 0 errors: 0 
failures: 0 

OK 


However, in running die tests, die script only asked for a 
single value for the GuessCount lsCorrect test. In looking at 
die test, we see that we call SetNewGuess only in the set Up 
function. To see that we are asking for a new value each time in 
the test, we need to add a call to SetNewGuess before the call 
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to CheckNewGuess. After adding those calls, we can delete the 
call to SetNewGuess in the setup function. Our test now' 
looks like this: 

script |GuessCountIsCorrectI 

property parent : registerTestCase{me) 
on setUpO 

copy iib*s GuesaingGame to TestGuessingGame 
set TestGuessingGacne's testMumber to 40 
end setup 

- Do three guesses and check to see if guessConnter = 
3 

tell TestGnessingGanie to SetNewGuessO 
set testGuess to TestGyessingGanie's GetNewGuessO 
set GuessIsHighOrLDV to TestGnessingGame's 
CheckTheGuesa() 

tell TeatGuessingGaine to IncreraentGuessCounter() 

tell TestGnessingGame to SetNewGuessO 
set testGuess to TestGnessingGame*s GetNewGness0 
set GuessIsHighOrLow to TestGuesslngGatne ’ s 
CheckTheGueasO 

tell TestGuessingGame to IncrententGuessCounter() 

tell TestGuessingGame to SetNewGuessO 
set testGuess to TestGuesslngGatoe'a GetNewGuessO 
set GuessIsHighOrLow to TestGuessingGame's 
CheckTheGuessO 

tell TestGuessingGame to InccementGuessCounter() 

aet checkGuessCounter to TestGueasingGame'a 
GetCounterValueO 

should (checkGuessCounter is equal to 3, 

^guessCounter has the wrong count!") 
end script 


After making tliis change, tlie tests return the same resulls, 
hut it asks for a guess three times in the 
GuessCountlsCorrect test. 

With the addition of the tminier llinctioas, w^e are ready to 
create our game. To do this, we will aeate a short script to call the 
ftindions we have developed in this article and add it to die 
GuessingGame script hie. Our final script file is shown in listing 8: 

script GuessingGame 

property newGueas : 0.0 
property testNumber i 0 
property cbeckNewGuess : 0,0 
property numberOfGuesses r 0 
property checkTestGuess : 0 
property guessResponse : "test” 
property raogeResponse : "test” 
property checkResponse : "test" 
on SetNewGuessO 

set newGuesa to text returned of 
(display dialog “Pick a nutnber froim 1 to 100" 
default answer 
end SetNewGuess 
on GetNewGuess[) 

set guessResponse to CheckGuessCases{) 
return guessResponse 
end GetNewGuess 
on CheckGuessCases0 
try 

set checkNewGness to newGuess as number 
if checkNewGuess is greater than 100 then 
set rangeResponse to ^ 

"Your guess Is too high I Pick a number from 1 

to 100." 

else if checkNewGuesa is less than 1 then 
set rangeResponse to “> 

"Your guess is too low! Pick a number from 1 

to 100." 
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else 

set rangeResponse to "Guess is within range. 
end if 
on error 

set rangeResponse to ^ 

"Your guess is not an Integer! Pick a number from 

] to lOD." 

end try 

return rangeResponse 
end CheckGuessCases 
on CheckTheGuessO 

if checkNewGuess is less than testNumber then 
set checkResponae to ^ 

"Your guess is too low! Pick a higher number." 
else if checkNewGuess is greater than testNumber then 
set checkResponse to 

"Your guess is too high! Pick a lover number." 

else 

set checkResponse to “You picked the right 

number I" 

end if 

return checkResponse 
end CheckTheGuess 
on IncrementGuessCounter() 

set numberOfGuesaes to numberOfGuesses 1 
end IncrementGuessCounter 
on GetCounterValue() 

return numberOfGuesses 
end GetCounterValue 
end script 

script theGame 

copy GuessingGarae to TestGuessingGarae 

set TestGuessingGame's testNumber to random number from 1 
to 100 


repeat until TestGuessingGame*s checkResponse = ^ 

"You picked the right Qumberi” 
tell TestGuessingGame to SetNevGuess() 
set checkCuess to TestGuessingCame's GetNevGueas() 
if checkGuess is not equal to “Gueas is within 
range." then 

display dialog checkGuess 

else 

set checkGuess to TestGuessingGame‘a 
CheckTheGuess() 

display dialog checkGuess 
end if 

tell TestGuessingGame to IncrementGuessCounter() 
end repeat 

display dialog "You guessed the right answer in " "■ 

^ TestGuessingGame's numberOfGuesses & " 

guesses I" 
end script 

run thsGame 

Conclusion 

This series has ciemonstrated some of the principles of test- 
driven development, and liow to u.se these principles in 
develojiking AppleScript programs. By u.sing these techniques, 
you can develoji well-tested code and be able to refactor and 
Lifxlate your applications with confidence, knowing that you 
have a set of tests to ensure tlvar your changes work. 1 
rectHumend the following resources for using ASLlnir in your 
[X'ograins: 

The author of ASLlnit has a set of tests fL>r his SafeTermiiial 
applicauon at 

h ttp: / /n i rs. Freeshel I. org/ code/SafeTe rm i na! / tests/ 

Matt Neulx.Tg's bcK)k, AppleScript: The Definitive Guide Ls a 
treasure of inf{)rmation on AppleScript development 
(http://www.orei 11/. com/catalog/opplescpttdg2/mdex.html) 
Gharles Ross has written an excellent article on using 
ol:)ject-oriented programming concepts in AppleScript at 
http://www.atpm.eom/9.02/rotlshtml 

Wikipedia’s entiy on test-driven development covers a wide 
range of resources at 

http://en.wikipedio.org/wiki/TesLdriven_development 
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Multisession burning reinvented 


BurnAgain DVD 


Multiple Sessions - one Volume. 
Add files to your CD or DVDRW 
several times - without creating 
multiple volumes. 


"BurnAgain is quite possibly the smartest burning utiiity 
I've seen for Mac OS X,.. "tuaw.com 


DOWNLOAD AND TRY NOW 

http ://f ree ridecod i ng. com/bu rnagai nd vd 
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Reliable Handheld Synchronization for Mac 


Thanks to The Missing Sync, Mac users are no longer second-class citizens when it comes to keeping their 
mobile devices in sync. Whether it’s a Windows Mobile 6 device, a BiackBerry or even a Palm Treo, there’s a 
Missing Sync product made to connect and synchronize that device with Mac OS X. 


Syncs Contacts, Calendars, Tasks 

• Supports Address Book, iCal, 
Microsoft Entourage 2004 

• Outstanding field support, even 
syncs Address Book contact photos 

• Supports calendar event reminders 
and detached events 

• Sync Services-savvy for syncing 
with third-party apps 


Complete Notes Syncronization 

• Includes Mark/Space Notebook for 
Mac to create, edit, categorize, sort 
and search through notes 

• Also supports Microsoft Entourage 
2004 and Bare Bones Yojimbo 

• Full support for Sync Services and 
.Mac syncing between Macs 


iPhoto and iTunes Integration 

• Imports photos and videos from 
mobile devices into iPhoto albums 
or folders in the Finder 

■ Resizes and downloads selected 
iPhoto albums to the device for 
handheld viewing and slideshows 

• Downloads DRM-free music and 
podcasts for mobile playback 


The Missing Sync for BiackBerry, Palm OS or Windows Mobile is available in single-user licenses for $39.95 
or in multi-user packs for any size organization. The Missing Sync family of products provide a Mac-centric 
synchronization solution second to none. 


Visit www.markspace.com/reliable today to see how easy it is 
to sync the latest smartphones and mobile devices with the Mac. 
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by Rich Warren 


The Announcement 

On March 6, 2008, Apple outlined ihe future of the iPhone. 
Phil Schiller, Senior Vice President of ^brld Wide Product 
Marketing, presented new and upcoming enterprise features. 
Scott Forslall gave us a peek into the much-anticipated iPhone 
Software Development Kit, and Apple CEO Steve Jobs 
described the iTunes Application Store. 

All of the features will be included in the iPhone 2.0 
update, expected in late June. While a free update for the 
iPhone, iPod Ibuch owners will have to pay for it. 'Hie cost has 
nor yet been announced. 

Meanwhile, beta prt>grajiis arc availal>lc for boih the 
ildione SDK and the enterprise Icaturcs. Apj^le hofK.^s to get as 
much feedback as possible before the 2.0 update goes live, so 
some t)f the details discussed below might change tieibre the 
actual release. 

Note: While 1 specifically talk about the iPh{>ne in this 
article, almost everything ap[dies to the iPod Touch as well. 

Enterprise 

Even though Apple originally targeted the iPhone at the 
consumer market, many businesses have expressed an interest 
in using it in the wa^rkplace. Unfortunately, the iPhone lacks 
several key enterprise features, liasically, corporation.s need to 
push data £3ut as soon as it becomes available, whether the data 
is an important email message, updates io a contact’s phone 
number, or a change in your meeting schedule. 

To be hone.st, as a sofm are engineer, push email confuses 
me. 1 mean, email is supp£.ised to i>e asynchronous, right? They 
write it at their convenience; 1 read it at mine. If someone needs 
an immediate response, they should call me. After all, the word 
“pheme" is right there in the iPhone’s name. But...Pm not a sales 
rep. What do I know? 

And 1 must admit, the iPhones enterprise features look 
impressive. Apple has licensed Microsoft’s ActiveSync prottx'ol, 
allowing the iPhone to communicate directly with an Exchange 
server, 'fhis gives enterprise users push email, push calendar, 
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push contacts, access to a global address list and the ability' to 
remote wipe the phone. 

Apple will also provide an enterprise developer program. 
This will Lillow' corporations to develop and distribute 
proprietary softw^are for internal use. 

The SDK 

While many people are excited by the Enterprise 
announcements, clearly the SDK was tlic .star of the show. Last 
October, Apple announced that they would release the iPhone 
SDK in Fel)Riai 7 , anti developers liave held an impatient vigil 
outside the Cupertino campus ever .since. 

Let’s take a quick look at the iPhone OS and the tools 
available to iPhone developers. Then we'll try a brief snippet of 
code, and discuss the path to becoming a real iPhone 
developer. 

The Layers of iPhone OS 

Apple introduced the iPhone OS a.s a series £)f layers; Core 
OS at the bottom, and Ccxoa Tt^iich at the top. 


iPhone OS 



The Core OS forms die foundation for all other layers, and 
the OS X Kernel is the foundation for the Core OS. This is 
basically the same kernel used by Mac OS X. Apple has 
optimized its performance in low memory situations; however, 
they still build die iPhone Kernel out of the same project, using 
die same source code, as the Mac OS X version. 

WWW.MACTECH.G0M 





















OtliL-r Core OS features include: a BSD networking layer, 
access to Boiijoiir, and advanced power management. 

Power management on the iPhone goes lieyond the 
already impressive systems built into Apple's portable 
computers. Said Scott Forstall, 'The Core OS power manages all 
of the chips, all of the sensors, the entire operating system, and 
your application also, automaLically.” 

Core OS 


os X Kernel 
Lib System 
BSD TCP/IP 
Sockets 
Security 

Power Management 
Keychain 
Certificates 
File System 
Bonjour 

Next comes The Core Services layer. This includes a 
complete set of Aids for accessing many of the workhorse 
services on the iPhone, While they may not seem flashy and 
exciting, they' make our applications tmly useful Of course, the 
Core Location API brings a little sparkle and pizzazz of its own. 

As you probably already know, the iPhone's Maps 
application can use cell towers and wireless hotspots to 
triangulate your position. The accuracy will vary, depending on 
the number and quality of the signals you can see, Not enough 
signals, and your location is simply not available. Still, tliis is an 
impressive piece of teclinology. 

Now these location-based features are available to third- 
party developers. The Core Location API will let us build 
location-aware applieations; programs tliat know our current 
location, and respond appropriately. 

Core Services 


Collections 
Address Book 
Networking 
File Access 
Core Location 
Net Services 
Threading 
Preferences 
URL Utilities 

In many ways the iPhone is, first and foremost, an iPod. 
Not suriirisingly, it comes with a rich set of media features. 

The Media layer starts with the Core Audio API. This is the 
same, low'-leve! API used on the Mac OS X. It forms the basis 
of Apple's consumer and pro audio applications. 
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Apple then liuilt OpenAL on top of Core Audio, While 
primarily of interest to game developers, OpenAL provides an 
industry standard API for rendering multi-channel, three 
dimensional, positional audio. 

Meanwhile, on the visual side. Core Animation provides a 
powerful set of APIs for easily creating layered animation. While 
it was initially introduced for Leopard, in 
many ways Apple built Core Animation 
for the iPhone. Its user interface heavily 
uses Core Animation. Almost all the 
transitions are based on Core Animation 
effects. 

And, OpenGL ES is the embedded 
version of tlie popular OpenGL 3D 
graphics API. This provides a subset of 
the full OpenGDs functionality, 
providing a simplilied interlace wnth 
many of OpenGCs redundant or 
inefficient features removed. This gives us a lightweight API 
who.se performance is comparable to the heavier desktop 
version. 

Media 


Core Audio 
OpenAL 
Audio Mixing 
Audio Recording 
Video Playback 
JPG, PNG, TIFF 
PDF 

Quartz(2D) 

Core Animation 
OpenGL ES 

Finally, Cocoa Touch replaces the Cocoa UI from Mac OS X, 
The mouse and keyboard are gone. Instead, Apple built 
tlte iPhone UI around touch as input. The advanced multi-touch 
event system sits front and center. This handles everything from 
single finger touches, to multi-finger touches and complex 
gestures. 

This layer also provides access to the camera, and to the 
iPhone’s full, 3-axis accelerometer. 

Cocoa Touch 


Multi-Touch Events 
Multi-Touch Controls 
Accelerometer 
View Hierarchy 
Localization 
Alerts 
Web View 
People Picker 
Image Picker 
Camera 
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“In many ways 
the iPhone is, first 
and foremost, 
an iPod.” 
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Merlin 2 


Project 
Management 
with 
a bit of 
Magic! 


Just three out of hundreds of features: 

Network-based Project Management 

Collaborate with others on the same 
project over the network. Just with a 
single mouse click. 

Automatic sync to iCal 

Sync your projects to iCal and then 
^ onto your iPhone or any other 
mobile device. 


Professional Cost Calculation 



ProjectWizards 

Merlin 2 is built from 
project managers for 
project managers. 


Get your free demo version 
www.merlin2.net 
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Define Budgets top-down or bottom 
up and compare them to planned vs. 
actual costs. 


Development Tools 

Now that we understand the basic layout of the iPhone OS, 
how do we manipulate it? Wll, iPlione developers use four 
main tools: Xcode, Interface Builder, Instamients and the 
iPhone Simulator. Every Mac developer should instantly 
recognize the first three. They are the standard development 
tools used for Mac OS X. Now, Apple has enhanced them to 
support iPhone projects. Tlie Simulator, on the other hand, is 
an iPhone specific addition to the developer's toolbox. 

Xcode is a powerful IDE for building and managing both 
Mac and iPhone projects. The new version of Xcode includes 
three templates for iPhone applications: Cocoa Touch 
Application, Cocoa Touch List and Ccjcoa Touch Toolbar. 

As you would expect, all of Xcode' standard features still 
work when developing for the iPhone. For example, code 
cc^mpietion recognizes for lioth the Mac and iPhone APIs. 

AdditicMially, if you’ve ever done embedded development, 
then you understand that the development cycle can be painful 
First you compile the application. Then you transfer the 
application otito the device. Finally, you launch and test the 
application. Often, each step requires a separate tool. 

Xcode reduces this to a single click, just press the Build 
and Go button, and Xcode will compile your application, 
transfer it to either the Simulator or to your iPhone 
(depending on the target settings) and launch the 
application. More importantly, the Xcode debugger allows 
you to rennHely debug your application while it mns on 
either the SiniuhUor or cm the ilditme itself. 

Next we have Interface Builder—and a complete library of 
iPhone-specific controls. Interface Builder alkm^s you to 
visually lay nut and design your user interface. You can draw 
the connections between your objects and your interface, It is 
even a powx'rfu] localization tcK)l 

Instruments provides a powerful suite of performance 
analysis and visualization tools, based on the DTrace 
analysis engine. Just like fhe debugger. Instruments allow^s 
you to remotely monitor applications running on either the 
.Simulator or the iPhone. You can record a wide range of 
.system behaviors, from network and file activity to CPU 
sampling and memory usage. Different elements are shown 
on parallel tracks, allowing you to quickly and easily spot 
correlated issues. Instruments can also access the stack 
trace, giving you access to the code executing at a given 
point in time. 

Finally, the Simukitor (as the name suggests) simulates an 
iPhone. It supports the entire API stack for the iPhone OS. It 
also comes with a few built-in applications, including a 
complete build of Safari. Yes, you can use the simulator to test 
web applications as well. 

Hello World 

All right, we’ve seen the OS and w^e’ve seen the tools Let’s 
look at a simple application. First, you will need to dow^rJoad 
and install tlie iPhone SDK. 
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Once tliat's done, open Xcode. Select File *> New 
Project.*.. Then choose Cocoa Touch Application, This will 
create a blank iPhone application. 

Now, open die My View .in file. Insert the following code: 

My View, m 

A mandatory Hello World application for the iPhone. 


SimpleBentatlon KyView 

- [voldIdrawRectICCGRect)rect I 

lIUTColor whiteColor] set]; 

Warld** drawXnRect^CGRettMakefO* 175 * 120 , 
50 ) 

withFont;[UIFout 

fontWitbName;@*'Mflrker Felt* size: 50 ] 


lineBreakMedetUILinEBteakModGMiddieTruncatlon 

all grm ent r UI Tex t All gnmen t C e nt e rJ ; 


@end 


This draws the words ‘'Hello World" in white, and centers 
it in tile iPhone’s screen. 

Now, click Build and Go. This will compile your 
application and lattnch it in die iPhone simulator, Thafs it, an 
obligatory "Hello World" application for the iPhone. 

Becoming an iPhone Developer 

Everything seems so exciting, right? “But^ I can hear you 
asking, ''How do 1 become an iPhone developer?" 

Apple has created a two-step process. First, you must 
register as an iPhone developer. This is free. Just go to 
htfp://dcve!oper.apple.com/ipbone/program, and click the 
Apply button. 

Registering not only allows you to download the beta SDK, 
it also gives you access to all the developer resources Apple has 
placed online. Take a \QOk at http://developer,apple.com/iphone. 
Tlais is your one-stop information depot for all things iPhone or 
iPod Touch, 

Apple has released an impressive array of informadon. 
There are ten Getting Started videos, from "Intrcxluction to die 
iPhone SDK" to ‘‘Leveraging iPhone Lfication, Acceleration, 
Orientation and System Information." Apple has also posed five 
Getting Started documents, ranging from an overview of the 
iPhone OS, to an Objective-C primer, and an iPhone SDK FAQ. 

Next, we have a selection of 15 Coding Flow-To's that dig 
into more specific topics. These include: handling multi-touch 
events, recording audio, triggering vibration, and writing secure 
ctxle, 

Apple even presents 13 sample projects. These 
demonstrate a variety of techniques and their actual use in 
applications. Again, we have a wide range, from the 
HeiloWorldClassic to AccelerometerGraph, LaunchMe, 
FingerSketch and GLGravity. 

Finally, Apple has included dozens of links into the iPhone 
Reference Library'. 



Any Time, 

Any Where Datca 

• Mobility: Data delivered anytime, anywhere 
in the world, 

• Synchronize data between FileMaker databases 
and now SQL data sources, easily and securely, 
no matter where they are. 

• For offline laptops or online home offices and 
multiple office locations - each local copy of 
the database synchronizes its data with the 
others, automatically or on demand. 

• SyncDeK encrypts all data transmissions, 

• SyncDeK works with your databases behind 
your firewall to prevent intrusion, or keeps all 
database copies completely decentralized. 

• Protect mission critical data with SyncDeK's 
continuous offsite differential data backup, 
warm standby and fail-over servers, 

• Sync servers with client-free server replication. 

• Version Update Martager allows you to update 
all copies of the database without requiring 
installation or any action on their part. 

• Call for demo, trial and best pricing options. 

WOrldSaync 

877.548.4920 toll-free 
510.548.4920 international 
www.worldsync.com 












It has a beautiful touch screen, gorgeous 
form-factor and amazing capabilities... 
Our Job is to keep things that way. 
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Same Day Shipping 
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MacBook 
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Memory Expert 
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Professional, Fast, Dependable 


So, registering as an iPhone developer allows you to 
download the SDK, build and run applications on the simulator 
and access aO the resources listed above. Bui, if you want to go 
further, you need to join the iPhone Developer Program. 

The iPhone Developer Program costs $99-00. This allow’^s 
you to build and nm applications on the iPhone itself You can 
also submit applications to the iTunes Application Store. 
Unfortunately, Apple is only accepting a limited number of 
developers during the Beta period. As I write tliis, the initial 
slots have already been filled, and Apple has a considerable 
w^aiting list. 

Don’t Forget Web Applications 

While the new SDK was tlie obvious focus of the March 
6th event, Apple also made quite a fuss over the existing 
Udione web applications. Over 1,000 applications so far, and 
counting. Despite the new SDK, the web apps are not going 
anyw^here. 

‘WeVe really been investing in web applications, and 
tlieyVe been incredibly successful. In this next release, we Ye 
going to add even more features to make the experience even 
better.’’ Said Scott Forstall. 

Expect good things for web apps in iPhone 2.0. 

One more thing... 

In true Steve Jobs style, tlie March 6th event had one last 
surprise. The venture capital firm Kleiner Perkins Caufield 8^ 
Byers announced the creation of the iFund, a SIOOM investment 
initiative to fund projects for the iPhone and iPod touch. ''That 
should be enough to start about a dozen Amazons or even four 
Googles,” said John Doerr, Partner at KPCB, “and if we’re 
running out of money, well look around to tty and find some 
more.” 

KPCB sees the iPhone and the iPcxI Touch as a new, 
transformative platform. “Think about it. What the iPhone’s all 
alxmt is, in your pocket, you have something thafs broadband 
and connected all the time, Ifs personal. It knows who you are 
and where you are. Thafs a big deal, a really big deal,” .said 
John Doerr, “Ifs bigger than the personal computer.” 

KPCB plans to fund everything from small startups to large 
expansions. Their focu.s areas include location-based services, 
social networks, mCommerce, communication and 
entertainment. They are currently accepting applications online. 

Check out http://www.kpcb.com/iniKatives/ifund/ 
index.html for more information. 

Public Response 

Immediately following die beta release, the Internet filled — 
with the groans, cries and gnashing of teeth. Many 
technopundits began complaining almost immediately, dieir 
glasses apparently stuck at half-empty. Most of die complaints 
focused on restrictions in the SDK. I wall explore some of their 
arguments and counter-arguments below. 
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Apple's going to take 30% 

Actually, relatively few people have complained about 
Apple's cut. Similar programs often take a much larger slice 
of the pie. Handango, for example, takes 40% off the top. 
But, we .still have a lot of unansw^ered questions about the 
App Store. We know' we can offer free softw^are, and we can 
provide updates. But, how can w^e 
handle downloadable demos? Can we 
offer special promotions or bundles? 

Can we give away free review copies for 
promotional puri>oses? 

This starts to pick ai the real issue. 

While developers largely won’t argue 
over ilie price, they do complain about 
the exclusivity. We have no choice, if wc 
want to distribute our applications, we 
must go through iTunes. 

Apple fully intends to vet all our 
applications, but wc don’t yet know^ how^ restrictive they will 
he, After all, restrictions for stability, security and safety are 
probably for the l>est. No one w^ants an unstable phone. But, 
will Apple restrict applications for purely business reasons? 

Amazon's online music store directly competes with 
iTunes, What if Amazon built an iPhone application for 


purchasing their music directly from the iPhone. Would 
Apple allow this? 

On the other hand, assuming our applications are legal, 
porn-free and play well with others, Apple should give us their 
blessing. This puts us in the App Store—in the one and only 
place people can go to look for iPhone applications. Everyone 
will come to this w'atering hole. 

The App Store should become an 
excellent resource, especially for 
smaller developers. We don’i need to 
set up an online store, or manage credit 
cards. We just put tire application up, 
and collect our checks at the end of tlie 
month. 

Of course, the store may go the 
way of the iTunes Podcast directory. 
Bigger developers might cjuickly grow^ 
to dominate, pushing aside newcomers 
and smaller teams. 

It w'ill be interesting to see how this actually plays out, but 
I suspect smaller developers may need to marker their 
applications outside of iTunes, or they will \usi get lost in the 
crush. 



The App Store 
should become an 
excellent resource, 
especially for smaller 
developers. 
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and contact 
management 
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organization. 



Now I Up to Date' and Contact'5 

Calendar and Contact Software for Business, Groups, Families and You. 



Is this project on schedule? When are you available to meet about the systems 
upgrade? Where are all the field techs today? When the last time anyone talked 
to our biggest customer? 

Virtually all groups live (or die) by their abilities to meet deadlines and keep track of 
their customers, prospects, and vendors. Few small companies or even departments 
of big companies hove the tools they need. 

Now Up-to-Dote & Contact might just be the calendar and contact software for you. 
It's time-tested and used by more Mac-based companies than any other solution. And 
ifs cross-platform-ovailoble for your PC users, too. It's easy to install and manoge and 
simple for your employees to understand and use. 

Using Now Up-to-Dote Si Contact you can schedule meetings for multiple users, view 
multiple, simultaneous calendors, and reserve rooms and resources. You can share 
contact informotion about your customers, prospects and vendors. And using our free 
server software you can set it up in minutes and shore with users in the office or from 
anywhere with on Internet connection. 
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Colt us now at 866-'527'€556 or email us at inactech@nowsoftware.com 
and well send you our free evoluatton kit, including the book that wilt 
make it all eosy^ ''Toke Control of Now Up-to-Date St Contact" from 
Take Control books! 


Copyright 0 2CK>6 by Now Soffwiane, Jnc- AH righhs reserved. Now Up-}i«?-Pote arid Nqw Corilact are reglsJered trodemarks of New Soffwane, Jnc. Mac and fh® Mac ara fnodemarks of Apple Cotnpor&r, Inc.. 
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Only one application at a time 

The lack of background processes has become a major 
source of complaints. 

Pul simply, we cannot run our applications in the 
background. Our application will shut down as soon as wc 
open sometliing else. TliLs is particularly trouhlesome, since 
outside events can trigger shutdowns. As soon as a call comes 
in our application quits. 

Of course, most program.s should just save their state 
before closing, then reload when tlie user next needs them. For 
many applications, tliis will seem nearly transparent, 

A few applications, however, reiilly benefit from running in 
the background. The AIM client is an often-cited example. 
Every time your phone rings, or every time we switch to a 
different application, the AIM client shuts down. When it shuts 
down, it logs us oft. 

On the plus side, the lack of background processes 
prevents a wide range of p<:)tential problems—from spyware to 
memory leaks, from battery life to siahiliiy. Having one 
application at a time really limits the damage that we can do to 
ourselves. 

No plugins or interpreted code 

Apple has clearly stated that they will distribute iPhone 
applications exclusively tliruugh tlieir store. They want a chance 
to vet all incoming code, and the ability to monitor and track 
any malicious or problematic applications. 


Plugins and interpreters offer a back dfx>r to the iPhone, 
They would let de%"elopers sidestep Apple's controls. 

On the surface, the restriction against plugins and 
interpreted code doesn’t seem like a big deal, but many popular 
desktop appUcatioas, like FireFox or Adobe Phott)shop, rely 
heavily on plugin architectures. Of course, those developers 
could simply limit plugins for the iPhone version—prtivide a 
bundle that pre-loads the most popular plugins, and disable the 
ability to add additional ones. 

More to the point, mobile applications should feel more 
fcKused than their desktop siblings. They should provide a 
single soliuion to a single, tightly defined problem. In many 
ways, plugin architectures run contrary to this design goal. 

No VoIP over the cellular network 

I have trouble believing that this really surprised anyone. 
Obviously, Apple's cellular partners would prefer that we used 
(and paid for) our cellular minutes, and Apple needs to protect 
their partners, at least to scjme degree. To me, this was a no 
hrainer—kind of like asking whether Apple would restrict jail 
breaking applications. 

Most people seem to agree. Many fell tliat limiting VoIP to 
wireless networks w-as not only reasonable, but completely 
expected. Most were just happy to have wireless VoIP. 

I have to code in Objective-C? On a Mac? 

As a Mac u.ser and developer, it's easy to forget how deeply 
the iPod and iPhone have penetrated into the Windows 
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world. While Tm excited about the possibility of developing 
iPhone apps with Objective-C on my Mac, For many, this 
may be a strange and somewhat frightening experience. But, 
really. What did you expect. 

Where is Interface Builder? 

This seems more like disappointment than a complaint. 
After seeing the Interface Builder In action, many developers 
eagerly downloaded the SDK, opened their new version of 
Xcode, and then realized that the iPhone version of 
Interface Builder was still missing. 

Beta Release. Look up the definition if you have any 
questions. 

The Silent Majority 

while there is some validity to these complaints, they 
haven’t .stopped developers from flocking to the iPhone 
SDK. The numbers speak for themseives. According to 
Apple, over 100,000 people downloaded the SDK in the first 
four days. 

An overwhelming number of developers also applied lor 
the iPhone Developer Program. 1 mean that literally, Apple 
was overwhelmed. While we don’t have hard numbers, it took 
Apple several days to process the initiiil applications. After 
wailing patiently, a ntmiber of developers (including yours 
truly) received brief emails. Ttiese explained that the initial 
number of beta developers had already been filled, and that 
we would be notified as additional slots became available. 
Three days to get a canned email response—that’s practically 
a denial of service attack. 


Conclusion 


Tlie iPhone 2.0 release will truly mark a new era for the 
iPhone. Apple w'iR release a number of improvements to die 
iPhone OS itself, including the new Enterprise feittures, lliey liave 
also announced parental cxintrols, wliich can limit access to 
appfcitions like tlie App Store or Safari. Additionally We should 
see improved support for web applications. Most imponantly, 
however, iliiid-party developer will release a wide range of new 
applic^ations for our phones, 

Tlie iPhone SDK sent waves of excitement rippling 
through the developer community. Sure, there are a few 
unrepentant critics, but most of the responses liave been 
overw^helmingly positive. 

The iPhone provides a unique, advanced platform witli many 
intriguing features. Once out applications get Apple’s approval, tlie 
Applicalion Store gives us instant acces,s to a woridwide market of 
iPhone and iPod Touch owmer>. 

Finally, the iFund promises to create a collection of new 
companies and communities centered amund the iPhone, 

I can hardJv wait to see what June brings. ^ ^ 

ijii 
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The Road to Code 

by Dave Dribin 


area and perimeter. Its interface is shown in listing 2. The user 
interface itself is stored in a nib file and created by Interface 
Builder. For the full source code, please download the projea 
file from last month's article. 


Cocoa Puffs 

Views, controls, actions, 
notifications, and delegates 


Listing 1: Rectangle interface 

ffimport <Foundation /Toundation. h> 

(^Interface Rectangle t NSObject 
I 

float 

float _bo-r^.croiV; 
float 

float _ii eight; 

[ 


^property float leftX: 

^property float bottomY; 

©property float width: 

©property f\oai height; 

©property (readonly) area; 

©property (readonly) float perinieter; 


[.ast month in The Road to Code we wrote our first Cocoa 
Gin application. This month, we're going to explore some of 
llie CcKoa tia.s,ses working tiehind the scenes. Every application 
has different needs, so we're also going to show how Cocoa 
provides ways to customize its Ixdiavior. To recap from last 
month, we created a simple rectangle calculation program. '1 he 
resulting user interface (UI) is showm in Figure T 


- [id) initWithLeftX: (Mom) leftX 

bottoroY; (floai) bottomY 
righiX: ('Mat) rightX 
topY: (l ioaM topY; 

Listing 2: HelloWorldControUer interface 

# imp 0 r t Co c 0 rr / Co c a, b' 


O_Window 

Rectangle Width. S 

Rectangle Height; 10 
Rectangle Area* 50 
Rectangle Perimeter; 30 

^ Calculate ^ 

Figure 1: "Hello World" rectangle application 

Rememt>er that our application consists of two classes, 
Rectangle and HelloWorldController, The 
Rectangle class represents a geometric rectangle and is 
responsible for the area and perimeter calculations, The 
interface for the Rectangle class is shown in Listing 1, The 
HelloWorldController class has outlets and actions that 
are attached to various parts of die user interface. It responds 
to the user clicking on the CalGulate button by updating the 


RectangJ.=v: 

is^iirterfaetf HelloWorIdContraller : NSObject 
i 

riiOutle- NSTextField ‘ ^widthFleld; 
tBOutlet NSTextFleld * ^eishtField; 
rBOuti^L NSTextField ’ _ateaLabel; 

MSTaxtFisld * _perimiterLabel: 

Rectangle * ,rectangle: 

1 

- fTBActlan) calculate; [Id) aender: 

■ {IBActiou} textFieldAction: [id) sender; 

@end 

So what makes tliis ap(>]ication tick? JIow does it work? 
What other classes are involved in mnning a Cocoa application? 

Objecooriented programming maps nicely to GUI 
programs liecause a class typically represents each visual GUI 
cc^mponent, and Cocoa is no different. By looking at our 
mnning applicatkm, yt)u can see that it has three different kinds 
of GUT components: six labels, two text fields, and a button. 
You know from our outlets that the text fields and labels are 
both of a class called NSTextField. Labels are essentially just 
readonly text fields, Tlie button is implemented by the 
NSButton class. The NSTextField and NSButton classes 
provided by Cocoa are called controls. A control is a GUI 
component that has three primaiy^ responsibilities: 
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I landles user interaction (keyix)ard and mouse events) 
Draws itself' on the screen 
Sends action messages 

Each control handles these responsibilities as appropriate 
tor the data it displays* For example. NSButton draws the oval 
around the text. It also handles mouse clicks by updating its 
Ionic accordingly and sending an action to the target. 
Remember that we hooked up the action £)f the button to the 
calculate: method of our controller. NSTextField is a 
control to display simple, one-line text* For an editable text 
field, like tho.se representing the height and width, the text field 
handles keyboard events so that the user can edit its contents. 
Text fields also have actions, even though we didn't use them. 
A text Field sends its action when tlie user has finished editing 
it, either by hitting Return or by changing focus from tlie 
selected text field. As an exercise, let's add diLs action to our 
coniroller: 

- (fBAction] textFieldAction: (ici) sender 
i 

field action: 

[sender strlngValiiej); 

1 


Now, htx)k this up to botli editable text fields for the width 
and height in Interface Builder and run the application. If you 
click between the two text fields, you should see output in the 
console. In our application, we don't need these text field 
actions, but the point is that all controls have actions which you 
c'an attach to. 

To gain further understanding about him buttons and text 
fields work, we need to examine the inheritance liierarchy for 
NSButton and NSTextFicld, as shown in Figure 2. Well 
Stan at the top and work our way down. 


NSObject 


NSResponder 


NSView 


NSCorttrol 


NSText Field 


NSButton 


Figure 2: Control hierarchy 


First let's look at NSObject. Remember diiii all classes 
have NSObject at tlie rout of dieir family tree, mil NSButton 
and NSTextField are no different. NSObject provides basic 
methods for all Ohjective-C objects .such as alloc, init, and 
release. All of our objects fmve used NSObject as their 
parent, too. 

Just below NSObject is NSResponder, and it's 
responsible for handling user events. Any class that needs to 
interact with user events, such as keyboard and mouse events, 
must inherit from NSResponder. NSView is next, and it's 
responsible for drawing to the screen. Because it inherits from 
NSResponder, it can also handle itser events. Finally we get 
to NSControl, which adds sup[>on for actions. Thus, die three 
responsibilities of a control are really implemented by three 
separate classes: NSResponder, NSView, and NS Control* 

Apan from NSTextField and NSButton, diere are two 
odier Cocoa classes that make up our appliaition- NS Window 
and NSAppllcation. Bt>ih of these classes have 
NSResponder as their direct superclass, as .shown in Figure 3. 


NSObject 


NSResponder 



T 

t 




NSWindow 


NSAppllcation 


Figure 3: Window and application hierarchy 

The NSWindow class repre.sents a windtw It handles the 
window events, such as closing and maximixing, and Is 
e.ssentially a container of views. A view mu.st be part of a 
window to be displayed. In fact NSView ha.s a window 
method that returns the NSWindow that contains it. An 
application may have more than one window, but only one 
window is active it a time. The active window receives user 
events and is called the key windouL 

The NSAppllcation class represents a Cocoa 
application. There is always exactly one instance of this class 
in any running Cocoa application, and it can be accessed one 
of two ways. The first is the sharedApplication class 
method, and tlie second is the NSApp global variable: 

// Two way^ to get the application instance 
NSAppllcation * appllcatlnn; 

application = [NSAppllcation sharEdAppllcationJ : 
application = NSApp: 


MMUKH 


The Road to Code: Cocoa Purrs 67 






























muMwcmme, 


Spectrum An^ysii 


Pwlft O' 


\ 

Meosure 2.0-4.0 GHz & 4.9-5.9 GHz bands 
Demodulate All 802.]]b/a/n/g packets 
User Selectable Power Triggers 
W.I.S.P. Antenna Alignment 
Multipath, MAC, SSID & Absolute Channel 
MAC Security Authorization Lists 
Interference Mapping Software (optional) 
RF Direction Finding (optional antenna) 


NOW SUPPORTS 802 .;in 


Y'ef/ow/acfcef B/A/G is perfect for /ocatijig 
and any devfce in yaur B02.npi 

Hqtji p gt Of P. notivortf incrtrdinp Appfe's Aifport frit? Bose 



Berkeley 

Varitronics 

Systems 

732-548-3737 


Serving the 
wireless industry 
for 35 years. 


www.bvsystems.com 


i usuaEy use the NSApp global, as it’s shorter to type. The 
NSApplication instance is responsible for running the 
application's main event loop. It handles all events sent by ihe 
underlying operating system and routes them to the correct 
NSResponder. Tlie NSAppllcation class also keeps track 
of all windows and which window is the key window. You can 
use NSAppll cat ion to customize an application's behavior, 
as we will see later. 

How Actions Work 

We used an action to customize what happened w^hen the 
Calculate button is pressed. Actions are possible due to 
unique features of the Objective-C language. GUI toolkits 
l>ased in otlier languages might require sulxlassing or other 
verbose language syntax to customize the button pressed 
behavior. Subclassing can still be used to customize the 
behavior of an existing class, bur it should generally be the last 
resort. Subclassing can make code more difficult to maintain in 
the future. 

Remember that actions have a method signature as 
follows: 

- (iBActriou) actionName: (id) sender; 

How does Interface BiiildcT tiook this up to a control, and 
h{)w does a cc^ntrol call this action^ It uses an Objective-C 
feature called dyncimic dispalcb. Dynamic dispatch is the fancy 
name for how the Ohjective-C language calls methods. 
Dynamic dispatch means Objective-C performs method 
dispatching at runtime, instead of static dispatch at compile 
time like C++ or C. 

While the compiler handles most of the work of translating 
Objective-C into machine language, part of the language that i.s 
linked into every Objective-C program is called the Ohjectioe-C 
nmlime. Among other things, the Objective-C nmtime does 
the actual method calling. W'hen you call a methcxl, like tliLs: 

[anObject aMetliod] ; 

the object you are calling a method on is called the target, and 
the method name is called the selector. Remember that ! said 
calling a method on an object is sometimes called sending a 
nies.sage to an object? Well, think of the target as the recipient 
of tlie messitge and the selector as the message being sene 
Under tlie hood, the compiler turns this method call into a C 
function call: 

objc„iiisgSend [anObject, r(jr(aMetbod)); 

Tile ob jc_msgSend function is part of the Objective-C 
runtime that implements calling methods by sending selectors 
to target objects. We Ye using the ©selector ke>T\wd to 
specify a selector Ironi a method name. It can acamliy be a bit 
dangerous to call method.s using selectors diiectly witli. 
obj c_tBSgSend unless you know what you are doing. 
However, NS Object provides a way to call a method from a 
.selector via the performSelector; method. This example 
shows how to call aMethod using this method: 

[anObject performSelector; §uelector[aMethod)]; 
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You won't see code like this wrinen most oF the time. It is 
a lot more to type, it is not nearly as readable, and is not as 
eFhcient as just calling the method directly. But dynamic 
dispatching of selectors gives the programmer a lot of Flexibility 
in calling methods of objects. Button actions are implemented 
using selectors, as we shall see shonly. 

Selectors even have their own type, SEL, so you could 
alternatively call this method as Follows: 

SEL selector ^ @selecior(aMethod): 

[anObJect perforaiSelectori selector]: 

One point about selectors is that you must include the 
whole methtjd name, including tile parameter components. 
Thus, iFyou have a method that takes two arguments: 

- (void) so^neHethodWltbObjectl: (NSObJect *) objectl 
andObjectZi (NSObject *) object2: 

the selector would be: 

SEL selector = 

e^selector (sosteHethodWithObject 1 :and0bject2:): 

You must include the colons in the selectors, too. A 
common error in dealing with selectors is to Forget colons, 
especially the last one. When youTe debugging code that uses 
selectors, he sure to clieck for them. 


Now, how does the selector busines.s fit in with aaions? If 
you look at the reference documentation For NSControl, you 
will find these four methods: 


When you control drag from a button to your controller to 
hook up tile action, Inierface Builder emails tliese metluids 
l>ehmd llie scenes. It calls setTarget: wi\h your controllcT 
object and set Act ion: with the selector of your action 
methtxl. Then, when the user click.s on your button, it calls 
your action method by using a variant of the 
perforaiSelector: method above. Remember that an 
aaion method has one argument, which is the calling contn^L 
Somewhere inside NSControl, there is code that looks similar 
to this: 

// Call the action method 

[[self target] perforraSelector; [self action] 
withObject: seif]; 

Notice that it uses the performSolector: withObject: 
method to pass an object to the action method. This is why 
action methods take a single parameter of type id. 


- (void) setTargot; (id) anObject: 

- (id) target: 

- (void) setAction; (SEL) aSeleotor: 

- (SEL) action: 
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The id Data Type 

Oh, and there’s that pesky id type again. It's time to 
ftnally come clean about it. The id type is a speciai data type 
that can point to any Objective-G object. Its similar to 
NS Object since most obj ects derive Irom N S Ob j e c t, bti t 
even more generic. It is possible to create a class that does not 
inherit from MSObject, iind the id type can point to those, 
too. One benefit is a matter of type safety: you can convert any 
object from an id to another Objective^C class witliout a cast. 
For example, this code compiles without any compiler 
warnings: 

id otiject = .,,: 

Rectangle * rectangle = object: 

On the other hand, this code w ill get a compile warning: 

NSObJect * object = 

Rectangle rectangle ^ object: 

Thi.s just means that you have tcj use a cast to tell the 
compiler that you really do want to use object as a 
Rectangle: 

NSObJect ‘ object = 

Rectangle ' rectangle = (Rectangle *) object: 

So why use the id type if all objects are inherited from 
HSOb j ect? It's handy when you don't want to use a cast. One 
good example is the objectAtIndex: method of NSArray 
we used a few months back. It reairns an id, and thus we 
don’t need to use casts every time we access the elements of an 
array. If it returned an NSObject it would mean a lot of 
useless typing. It’s also useful for the sender argument of 
action methods bcrause we don’t know the type of object 
sending the action. It could any one of the NS Control 
suix’lasses or even an NSMenuItem. Using id allows us to 
skip die casts when converting to die proper type. 

Notifications 

While Interface Builder usually hides die use of selectors 
for actions, otlier parts of Cocoa require using selectors directly. 
However, actions are just one w'ay to customize Cocoa without 
.subclassing. Anodier way to customize Cocoa is through 
fHHi/tcaiions. Ntitifications are a way to lirtjadcast an event to 
any object that Ls interested. Think of nodfications as an object 
picking up a megaphone and announcing that a certain event 
(xcurred to die W'hole application. Any object that is interested 
in this event can listen for it and do wliatever it wants. Selectors 
are used for notifications, too. For example, NS Application 
will send out a notification every time it becomes inactive, and 
we can register a method to be called (via selectors) w'lienever 
this notification is posted. 

Each notification must have a unique string name, and 
objects that are interested in a particular notification must use 
this name w^hen they register. The virtual megaphone, if you 
will, is called the notification center and is aptly implemented 


by a class named NSNotificationCenter. To receive a 
notification, an object must register itself with a notification 
center. 

The notification named NSApplicationWill- 
ResignActiveNotification is posted by the shared 
NSAppllcation instance when the application becomes 
inactive. We am modily our awakeFroinNib method to register 
our controller as an observ^er for this notification as follows: 

- (vald) awakeFromNib 
I 

I.^idtbFlsId setFlofltValue: ^rectangle,width]: 
LbeightFit^ld setFlostValue: ^rectangle.height] : 
tself ufidateAreaAndPetiineter] i 

NSNotlflcatdonCeDter * center 

[NSNotlficfltlonCenter dsfaultCenter] ; 

[center addObserven self 
selector: 

©selector(applinatiDnWlllResignActive:) 

name: 

NSApp1icationWillResignActiveNotification 
object: NSApp]; 

[ 

There are odier notificaiion centers, but usually the default 
notification center is used, as in this case. The dcx'umentadon 
should be clear alx)Ut which notification center to use, if you 
have any doubt. You can see that this registration method uses 
selectors to lie a particular notification to a method. 

The name parameter is the name of the notification we are 
interested in observing. The object parameter is the source 
of the notification, fn our case, there is only one instance of 
NSAppllcation, but other notifications may be tied to a 
specific instance of an object. For example, NS Windows send 
out notifications wiien they close, and you may be interested 
only in a particular w^tndow^ insiance closing, not all window^s. 
'I’he observer parameter Ls the target of a method cal!, and 
die selector parameter is a specific method on die target to 
call when the notification cxcurs. The end result of this is that 
the applicationWillResignActive: method of 
HelloWorldController will get called every time the 
application becmnes inactive. Let's fill in a simple 
implementation of this method: 

- (void) applicationWillResignActive: (NSNotification U 
notification 

[ 

NSLogC&'^Appiication will resign active**): 

1 

If you noW' run the application, you should see this log 
statement printed every time you bring another application to 
the front. NSApplication has a buncii of other notifications 
that you can use, a.s w ell. See the reference documentation for 
full irLformation. 

Oh, and you must not forget to unregister widi die 
notification center, w^hen you no longer want to receive 
notifications. Like calling release for every retain, you 
need to unregister for every notification you register for. This 
is especially important for non-garbage collected applications. 
If you don't unregister for notifications, the notification center 
w*ill tiy to call methods on a non-existent object, wjiich can lead 
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to ainiime errors. Thus, it is a good idea u> uniegisier in the 
dealloc method: 

- (void) dealloc 
I 

[_recTaiigle releaB&] : 

HSHotlflcatlonCEnter * center = 

[NSNutificationCenter defaultCenteE ]i 
[center retUDveObaerver: self]; 

[super dealloc]; 

I 

Tills removes an object for all notificatic^ns, which is handy 
if youVe registered for multipie notifications on multiple 
objects. You don’t need to do this cleanup for garbage 
collecied applications as the notification center will 
automatically unregister all notifications for you when your 
object is garbage collected. 

Delegation 

Notifications are good for broadcasting events to multiple 
objects, liiJt sometimes events need more one-on-one attention. 
Another way to customize l:>ehavior of certain Cocoa classes is 
througli delegation. Just like managers delegate decisions to 
their employees, delegation is a technique used where one 
object delegates certain decisions to another object. 

Lets stick with NSApplication as an example. You may 
notice tliat some applications automatically quit when their last 
window' closes to (Drevent the application IVoni sticking around 


unneces,sariiy, Tliis is actually a simple cu.stomization of 
NSApplication through delegation. 

The NSApplication object contains a reference to 
ant^ther object called a delegate. The delegate may customize 
certain actions of the application. For example, when the last 
w'indow of an application close.s, NSApp calls this method on 
its delegate: 


If the delegate returns YES, the application quits* 
Otherwise it continues running. The interesting thing about 
delegates is that there may be many delegate methods available 
for customization, but the delegate only needs to implement the 
ones it needs to customize. In this case, if the delegate does 
not implement thi.s method, or there is no delegate, then the 
default response is NO. 'Fhis is why our application currently 
will not quit if we close the window. 

Like actions, delegates for most GUI classes can be 
established m Interface Builder* I'm going to go through the 
proc'edure to setup our HelloWorldController as the 
delegate to NSApplication in order to customize this 
l^ehavior. Just like our controller class has outlets that can be 
connected through Interface Builder, NSAp pile at ion's 
delegate is also an outlet that can be hooked up through 
Interface Builder. Double click on MainMenu, nib to ftre up 
Interface Builder* In the MainMenu.nib window, you should 
see an Icon repre.senting the application. ControlHlrag from thi.s 
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G4 Gigabit/D Audio: $149 
G4 Quicksilver: $2 9 9 
G4 MDD: $489 
G4 eMac Logics From $189 
G5 Towers $399/S499/S599 
G4 Xserves $149-$299 
G5 xserves $599 



www.mac-resource.com 

Mac Systems I 


New Systems 
"'"Arriving Daily! 
Call for latest 
Stock. 


Power Supplies 


G4 tMac 15/17/20: $79/$99/$119 
G5 iMac 17/20: $149/$179 
G5 Tower : $ 1 69 / $1 99 
G4 Qsilver/0 aud1o:$179 
G4 Gig E-net/MDD: $199 
G4 AGP 208/237W: $129/$179 


i 




Processors For G4s, G5 ft Xserve: 
G4 466/733/ 800 $49/$ 149/$ 199 
G5 1.6/1.8GHZ S399/$499 
DUAL PROCESSORS ($ PER PROC.) 

1.8/2.0/2.3GHZ 399/549/599 
2.5DP/QP $699/$799 
X5ERVE PROCESSORS 
G4 1.33GHZ DP $189 
G5 2.0/2.3GHZ $229/699 


Thousands of parts 
_ for all M ac systems! _ 

1 - 888-Mac-Resource 


G4 46&Mhx S199 
G4 731/BOOMhz $S49/$449 
GS t.6/1.8Ghz $599/$699 

G5 t*B/1.0Ghz DP$799/$1199 
G5 I.5/Z.7Gtii DP $tl997$1S99 
G5 Z.SGhz QUAD DUAL DV| $1499 
MEED G5 IMACS? 

G5 1.6/1 .a/I .9Gh2 17- $ 6 49/$ 6 9 9/$ 79 9 
G5 1 .a/7.0/1.1 GHI 20" $799/$ 899/$ 9 99 
EMACS GALORE, GREAT WORK STATIONS 
700MHZ Z56/40GIG/COMBO/1 7” $149 
1.0GHZ ZS6/40GIG/COMBO/1 7" $229 
I.ZSGHI 256/40GIG/COM6O/17"S299 
t.AZGHI 256/aOG*G/SD/l7" Ssald out -- 

WE HAVE G5 XSERVES AND RAIDS 
EVEN IE APPIE DQESN'rilll 

''G5 XSERyE CLUSTERNODES FROM $1429 
G5 XSERVES FULL UNITS FROM $16991!!! 

1 TB XSERVE RA!DS FROM $2899!!!! 

2.8 TB XSERVE RA!DS FROM $3999!!!! 

5.6 TB XSERVE RA!DS FROM $54991!!! 

3.5 TB/7.0 TB XSERVE RA!DS $4899/$6299 
RA!D CARDS, F!BRE CARDS, DR!VE MODULES 
POWER SUPPLIES, CONTROLLER MODULES ETC 
OVERNIGHT SERVICE AVAILABLE!!!! 


Displays 


REFURBISHED DISPLAYS 
22"/23” Cinema: $429/$499 
15" Studio LCD: $69 
17" Studio CRT,ADC/VGA: $49.99 




Products refurbished or demo, 
call for more information 


























icon to your controller icon. Interface Builder should prompt 
you to connect an outlet by popping up a window. Choose 
delegate from the menu, as shown in Figure 4. 

ft MainMcnu.nib f2. 

axEsioi ■ 

' Vkwiftade 'Mo' . ■ 


^ ® lj ill 

1 Owner gander E321ED® WaJnlilenu Window Wind. 



Figure 4i Conneding the delegate outlet 


This makes our controller the delegate of the application, 
but it does not yet override any of the delegate methods. You 
need to add this method to your controller implementation: 

' t'BOOL) applicationShouldTerTidnateAfterLastWintlDwClosed: 

(NSAppIlcation *)theApplication 
I 

return YES; 

] 

If you now' run our application, it should quit w'hen you 
close the w'indow^ 

Delegates and Selectors 

You may be asking how, exactly, do ,seiectors fit into 
delegation? It's a bit more behind-the-scenes than actions and 
notificatitjns, hut ii\s useful to know if yoti want to setup your 
own delegates. As youwe seen, you mtist implement a specific 
method for delegation to work. You cannot customize whkh 
method as yt^ti can with notifications, for exam pie. It is sort t)f 
like subclas.sing NSApplieation and overriding a method 
without the hassle of creating a new subclass. If you step into 
the shoes of the person w^Ito wrote HSApplication, you 
would see tlie use of selectors again. 1 lere's how it would be 
implemented: 

fiOQL shoaldTerminatE = NO; 
id delegate = [a^lf delegatel^ 

SElj selector “ 

@EJ6lector(appllcatlonShouldTermlnateAftfirLastWindowCioBed:); 
if ([delegate respondsToSelector: selector]} 

I 

BhouldTemilnate = [delegate 

ap p 1 ic ati onSh o ul die rm ina t e Af t e r Las tWind oid C1 o e e d: 

self] ; 

1 

// Use ahouldTerininate 


Using respondsToSelector:, the application know's 
w hether or not tlie delegate implements this particular mediod. 
If it does not ipmlemenl the meditid, then the default value is 
used, Whafs interesting is that the application is asking the 
delegate, at runtime, if it implements the method. This means 
that HSApplication does not need to recompiled if the 
delegate implements the methcxl. This runtime decision is 
made possible due to Objective-C's dynamic dispatch. This is 
not possible in static dispatched languages, like C++ or C. 

Delegates and Memory Management 

Just as you must unregister for notifications that you 
register for in your dealloc method, you also need to remove 
yourself as a delegate to objects that you are delegate for in 
your dealloc method. Classes that have delegates only keep 
a weak reference to their delegate to avoid a circular 
dependency. If you are using garbage collection, again, you do 
not need to worry about removing yourself as a delegate. You 
also can have circular references without a problem, llie 
garbage colleciiun system liandles it all for you. You begin to 
see why garbage collection can save you a lot of effort. 

Delegates and Notifications 

One interesting side effect d setting up a delegate is tliat the 
delegate is also notified of any notification originating from the 
source object, if a particular delegate method is implemented. 
For example, applicationWillReslgnActive: is also a 
delegate method of HSApplication, So now that our 
controFer clas,s is the delegate for NSApp, we no longer need to 
register with the notification center to receive this notification. If 
we remove our notification code from awakeFromNib (and 
dealloc, if not using garbage collection), w^e will still be 
notified when die appliaition becomes inaaive. 

Conclusion 

WeVe covered bit more of how Ccx:oa applications work 
and how to cusiomize them. Using actions, notifications, and 
delegates provides great flexibility to customize without 
subclassing any of Cocoals classes. Be sure to read up on the 
reference documentation to see what notifications and 
delegates you may have available before subclassing. 



About The Author 

Dave Dribin has been wrifing prafessianal 
software for aver ^ven years. After five years 
programn^ eoAedded C m the tderm mifstry 
and a brief stint rhSag the Internet bubble, he 
deeded to venture outaahis own. Skice 200J, he 
has been providing independent consulting 
services, aadin 2006, he founded Bit Makf, inc 
Find out more at <http://www.bihmak{,coTn/> 
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72 MAY • 2008 


WWW.MACUCH.COM 



























Network, Server 
and Appliance Monitoring 
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Lithium Network Monitoring Platform 

Lithium can now monitor your Xserve, Xserve RAID, 
Qlogic switches, Airports, Mac OS X Server... 
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Getting Started 
with REALbasic 


Learning the ropes 


by Norman Palardy 



REALbasic is a Rapid Application Develpment (RAD) 
tool from REALMS oft ware, In previous issues weVe loc:)ked at 
it briefly and even talked with Geoff Perlmann, the CEO of 
REAL Software. This month we’re starting a series of articles 
that will focus on getting you started with REALbasic and 
learn how to be productive with it. For this series well keep 
current and use the latest version of REALbasic. For now, 
that means we ll be using REALbasic 2008rl, 

Getting started 

When you first start REALbasic, you see its splash 
screen. In figure 1, the splash screen tells me when niy 
update plan expires. REALbasic is a subscription that 
entitles you to ALL of the releases while your plan is active. 
Since REAL has been very good about providing consistent 
releases in their 90 day promised time Irame, every plan 
gets several updates while in force. 


8 REALbasic 2008 

I 

flegjjtered To Norman 
Vour update plan valid until r 22/CIS ^08 

Loddiitg Framewrork.. 


Figure!. REALbasic splash screen 

Once launched, you will immediately be looking at a 
new, empty project for you to start adding to. 


V REALbasic 2008 File Edit Project View History 

1^ ^ ll^ 

c-adc N»rwafU ftun Build Aidd Sookmartt 

SPmjeci 


Add. Window 9 Add Class O Add Module Add FoHIdef 9 Add 



Sup 

0 App 

App 

Q Window I 

Wifi^ 

13 MenuBjri 



Figure 2. REALbasic default project 
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Tills default project is a fully functioning program. You could 
immediately Rin it by pressing the green Run butt{)n. It won't do 
much, but it does demonstrate several things that you probably 
want your pn>gram to have. It has a menu bar tliat functions and 
windesws tliat you c'an drag around and close. The Quit menu 
item will quit your program as you ex]iect. 

Let's have a kxak at how we can add items to a windows If 
you double dick on Window! you should see a window like the 
one in figure 3. 



Figure 3. Editing a REALbasic window 

Down tlie left hand side is a list c;f the standard controls that 
are available in RFALbasic. Note that if you use the Personal 
version, this list may have fewer items. 

In the center is the actual editex w'here you lay out the look 
of your window. 

On the right is the properties palette that displays the 
properties of the currently selected item. 

To add a control like a PushButton to the window you can 
scroll the left hand list of controls dowm and double click on 
PushButton. Alternatively, there is also a contemial menu 
available that pennits you to add rantrols to a window. Some 
classes that have no visual representation may only bo added 
using this mechanism. 

HELLO WORLD 

lisually, the first program written in a programming language 
to illustrate how^ easy it is to do something is 'TleRo World”. In 
REALbasic tills is not very difficult since tlie default project is 
already a running application. 

Double-click on the item nmned Window 1 and add a 
StaticText control to tlie window^ by selecting it from lire left hand 
list of controls. 




Umbrella, sun screen, cooler not included. 
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^ Tinier 
9 UDPSocket 
m UpOownArrows 
gfll WordAppILcation 


. 


' '' il 

■’:l '■ ; ' 


□ o 
Ointitled 


’i/ifei’'- 
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■■ 
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Oouble-elick, drag, or click and then draw to create a new W 


Figure 4. Control list 


You’ll notice that after adding the control tliat it remains 
selected and it’s properties show up in tlie righi hand property 
inspector You’ll see that the ctjnLrol has a name, StaiicTexil, as 
well as position, si2:e and several other properties relatcxl L(^ the 
appearance of the text, plus the text itself. 

If you click on the ellipsis ai the right hand edge of the Text 
property a dialog will appear where you c'an type in any mess^ige 
you want. Type in "Hello World” and clexse the dialog by pressing 
OK. Immediately in the IDE you will .see that the message has 
changed. Now run thi.s project by clicking the green ''Run" buiton. 
and there’s Hello World in REALbasic f 

This window still dt^esn't do very much. I^lay around wath the 
various properties of the StaticText control to change the font, 
color, bold, italic, and see how those things affect the result. 

llie beauty of REALbasic is that it makes trying out these 
kinds of changes very easy. Some changes don’t even require you 
to run the application to see, as the IDE sliows their effect 
immediately. 


• My Application.debug File Edit 

r ^ ^ ^ 

% 0 Untitled 

Hello World 

J 

1 


Figure S. Hello World 


What we should do is decide on an ap[>lication tliat we w^ant 
to make over a series of ariides. Uten, in each tme, well add on 
new pieces. We’ll Ix^ on our w:iy to making the final product. 

rd like to suggest that wc buiki an applicaiitm for tracking 
the prices of stocks; perhaps an investment [portfolio we might 
hold. This will involve accessing the Internet to grab quotes, 
graphs and a database. 

We’ll have tc^ design the interface and the database as well 
as several windows for adding stocks to track. 

Until Next Time 

In the next installment well design the interface, the 
database and the windows we I! need for adding stocks to track. 
And we’ll get staned writing the basics to make the whole 
project come together. 

Thanks for reading along. I’m kx)king forw^ard to making 
this project come together mih you over the remaining 
installments and intrtxkicing you to REALl:)a.sic. 

7 iVi 
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Highest Security 


■ Vendor selectable secret and private key. 

■ Strong encryption algorithms with AES 128-bit and ECC 224-bit. 

■ Best-in-class tools for automatic protection {envelope, without source modification} 
for Win32, Win64, .NET, Java and MacOS X Universal (PPC, Intel). 

Best Flexibility 

■ More than 1000 independent licenses can be protected by one CM-Stick. 

• One versatile hardware key for all license models including floating network licenses. 

■ Multi platform support including Windows, MacOS X and Linux, 

New Distribution Channels 

■ License transfer by SOAP based CM-Talk or file based Field Activation Service in e-shops. 

■ Multiple-purpose, including protecting low cost software and digital content. 

Unique End User Advantages 

■ First and smallest dongle with up to 2 Gbyte flash drive. 

• No drivers necessary - can be used without administrator rights. 

■ CM Password Manager, secure virtual drive and secure login. 
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Leopard’s new options help you better manage 
rhobile computers 


By Greg Neagle, MacEnterprise.org 


Ml 



1^ 


MacEnterprise.org 

Mac OS X enterprise deployment project 


The Future is Mobile 


E;ich year, laptop computers comprise a larger percentage of 
the tc:>tal number of ne^^^ computers sold. This trend liokis even 
with Apple hardware. Liptcjp computers can be more challenging 
to suppc^n in an enteq:)rise enviranraent ilian tlieir desktop 
i:>rethren, since they're not alw:iys on your network. Fortunately, 
with each recent major nelea.se of Mac OS X, Apple lias added 
features that niiike using laptop in an enterprise enviromiient more 
manageable and more secure. 

OS X 10.3 "Pantlier" added FileVault and Mobile AccxjunLs. 
FileVauIt enables tlie encry[ition of user data, an important feiiture 
in an enterprise environment, where the intellectual property (data) 
on a stolen laptop can lx: far more vtiluable llian the hardware 
itself. Mobile Accounts allow network account infomxation to lie 
aiched locilly on the machine. Tills enabled petsple to ase tlieir 
network ctedentials to log onto their machines even when not 
connected to the enterprise network, and eliminated the 
administrative overliead of managing purely kK’al acaiunts tin 
enterprise laptops. 

OS X 10.4 ‘Tiger"" furilicT rehned mobile support with the 
introduction of Portable ! lome Directories. Tltis addition to Mobile 
AccounLs allowed users to .synchnmiHe a kx‘al copy of their data 
witli a network home diretioty. 

OS X 10.5 T^ipard" continues the refinement of mtibile 
support. New optioas include the ability to cieate a FileVault^ 
encrypted h(>me directory at the same time as creating a mobile 
acct)unt, and External Accounts, which bring many of the features 
of Mobile Accounts and Poruible Home Directories to removable 
media like FireWire drives and USB sticks. 

Leopard Mobility Enhancements 

An enhancement OS X administrLitors will apprcxiate is tlie 
new option to encrypt tiie local iiome directory when creating a 
mobile account. This saves a lot of time and makc^ it mom likely 
that your users wiD actually liave FileVault-pR>tecied acc’ounLs. 
Previously in Tiger, tliis required two steps: first, you or die user 


would create the mobile account, biter, FileVault would have to l^e 
manually aimc^ on for the newly created mobile account. 'Fhis was 
difficult to automate, and required an admin pxs.sword as well as 
die users fXLSsword. Even tf your users had the riglits to turn on 
FileVauk for themselves, many would not. lliLs management 
overliead made it far more likely tluit some of your mobile users 
were walking around with unencrypled home directories. 

In Leopard, when manually abating a niohde account from 
the Acct junis preference pane, you are given the option to protect 
dial account w ith FileVault. If you chocxse thi.s optkin, the FileVaolt- 
pn>tected home directory is cTeated at the same time as die mobile 
dCQOuni 

Home foider tn: Gi Leopard fStarttip diski _TI 

^ Use FiteVauJt 

feqtiires i m^ttr password, 


Sync. Automatically ’ t 

at login 
M at logout 
0 Home folder 
C Only selected folders. 

Sync ■ 


M Show status in menu bar 


( Cancel ^ ^ Create ^ 





































Tht? option to encrypt new mobile accounts is also available 
via tlie command line. Jjeopard includes a new mobile account tool, 
k)cated in /System/Library/CoreServices, inside the 
ManagedCllent.app bundle in Contents/Resources: 

Imldfiight:ManagedClient.app/Contents/Resources] gneagle% 

. /createmoblleaccount 

createntoblleaccount built Dec 5 2007 12:28:37 
error: no arguments 

usage; urEatemobiXeaccotint -n username [-h horaepath] [-P | [-p 
password]] [ e] [ q] [[-x] | [ X]] [[-s] | [-S]] [ u syncDlL] 
l-v] 

-n username : user record name 

-h homepath : user home path; Default Is **/Users/<^username 
-p paesword : user password 

-P : prompt for password. A password Is required for FileVault 
home 

*e encrypt ; encrypt new home with FileVault 
-q quota : max size in bytes of FileVault home 
-X : create as external account on non-boot volumes. Default 
-X : create as mobile account accomit non-boot volumes, 

-s : set home sync on if home created. 

•S : set home sync off If home created. Default, 

-u syncURL : server target of home synchronization 
-V ; verbose output 

Examples: 

createmoblleaccount -n jsmith 
createmobileaccount v -P -x *n jsmith 
createmobileaccount vsdn j smith h /Vsl ui!ies/HD3/jhoiae 
createmobileaccount -i 

Notes: 

- createmoblleaccount must run as root. 

- If you do not specify a password, the account's cached 
password will be created during the account's first log in. 


Perhaps of mort? interest to OS X administrators is the ability 
to cnftjrcc the option to encrypt the mobile home, Tliis can be 
done via MCX using Workgroup Manager, and allows you to 
ctyrifigure a machine so that if the user creates a mobile account, 
the k)cal home is encrypted with no additional effon. 

As you c^m see in Figure 2 (above), additional options include 
the abilit>^ to restrict the maximum size of a FiieVauli-proteaed 
home directory, and the ability to create tlie local home at alternate 
paths or on other volumes, 'fliese opiioas are also available in the 
createmobileaccount command-line tool. 

No Mobile Accounts? 

Even if you don't use mobile accounts, tliere are some changes 
in Leopard tliat assist witli managing laptops. 

When creating a local account using the Accounts pane, there 
is an option to protea tlie account with FileVault, again, saving a 
step. Though it is not dcxiumented by Apple, ycju can also enforce 
tills setting using MCX and Wtirkgrt^up Manager 

Tliis setting is l:>est managed at the Computer Group level. 
Create a Qjmputer Group for all yt^ur laptops (or a subset of them), 
or use an existing group. Select tlie group, then click die 
Preferences icon in the Workgroup Manager toolbar. 

In the Workgroup Manager's Preferences editor, select the 
Details tab. Click the + button to add a new preference domain. 
Navigate lo /Applications and double-click on the System 
Preferences.app. 


The -e option allows you to encrypt die Icxai home with 
FileVault as die mobile account is aeated. The useFs password is 
required. 

Workgroup Manager/Managed 
Client 
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Figure 2 
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High Quality Maps 

RouteBuddy toatums high 
quality map data, which is 
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Google and E911. 

Search Maps 
RouteBuddy can search for 
street addressee (irtoluding 
zipipDStal codes], or for Points 
of Interest of a given type in e 
certain location. Your library 
can also be filtered, to quickly 
locate an e>dsting object. 
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and share tracks 



Share Data 

RouteBuddy can link directly 
to Qfxigle Maps and Google 
Earth, allowing you to quickly 
Jump from your current location 
to alternative maps. 
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The com.apple.systempreterences preference doniain will te 
added to the Preferences Details editor, and it should look like this: 


Preferences , __ 

Qyiertfi&w - 


Modify ippJlcatlon preferences if\ the preference editor: 

flSPrelCrtiiCe ID 
comepple-MCXBIuetDoth 


aluetooth 

0 oM.appte.EirsianwBtersrKjffs- 
Dashlspai'd 
CJeslcTop Picture 
Dock 

FoEder Redirection 
Home Sync 
iCal 
tCfial 

Internet CpnRfjuratian 
iTunes 7 

(Work Resist ration 
Rertkero; Login 
Mail 


cx}pt.sj}pis.SiSte>mifre(m&}C0S 

com app le.da s h br[>a rd 

cam.appEendesktop 

com .apple .dock 

com. apple. MCXRed i rector 

com.app1e,home&ync 

com a pple iCsI managed 

com . a pole .iChat. M anaged 

com .aoola^ internet 

com.appte^fT unes 

cqm. apple JWarkQR 

edu .m it.Kei'berti£rKe rbe ro&log in 

CO m. apple .mall, managed 


•JL' ijH' Iz. 




Select die com .apple .systempreferences item, and click tlte 
jx^ncil to edit it. Delete all die ini{X>rted keys using the Clear button 
- you don't want any of diem, 

'liirn dowm the disclosure triangle next to the Always .section. 
The New Key button should become active. Click it. A new key will 
be created with the name New Item. Change this to 
com.apple.preferences.accounts.forceFVForNewUsers Change 
the type of the key to Boolean, and set its vakte to true. When you 
arc done editing, it should IcKik like tJiLs; 


com-appi i .ivstiJmprefe m nces 



Dons 






Click Apply Now to save your clianges. 

Cin d machine dial Ls a mernlier of the Computer GroLip you 
just edited, log in, open the Acctiunts preference pane, create a new 
account, and you II .see tliat Turn on File Vault protection is .seleded 
and cannot be deselected. 

FUeVault Improvements 

Leopard also brings a couple of improvemeriLs in File Vault, 
which should address some of the cx>ninion IssLies encountered 
when working witli Apple's disk encTyption technology . 

Under Tiger, if a mobile user changed ilieir network account 
passwcjrd somewhere other than on their laptop using Apple's 


ttx>ls, tliey could lock themselves out of their FUeVault-protected 
mobile account. Dealing witli this situation could lie a major p^iin 
for an OS X admin. Leopard makes die admin’s (and the useFs) life 
easier - in this simation, if the user has entered the correct network 
account password, but tlie FileVauit pas.swofd is different, they are 
prompted to enter their previous account password. This i.s used to 
unlock tlie FileVauit home directory and update its password, again 
without admin intervention. 

Mew Account: ' Standard _|T1 

Namb: [I j 

Short Marne; "" ” 1 

Password: " ^ I ; f 

Verify: 


Password Hint: 

(Recommend edi 

V : ■ vault proreetlor" 

Use secure virtual metnory 

r ? ^ Cancei ^ f Create Accaum ^ 


Of interest to users of lx>ih mobile and purely l(x:al accounLs, 
die FileVauit disk image formal has lxx:ii impioved in Leopard. 
FileVauit now uses a , sparsebundle disk image, rather than tlie 
, sparseimage fomiat used by previous versions of OS X. Ttie 
, sparsebundle feinna! is much faster when recovering unused 
space at logout, which should make File Vault-protected users 
happier. Apple also claims that , sparsebundles are "more 
reliable, efficient, and scalable" than the old , sparseimage 
fomiat. 

Conclusion 

Leopard's mobility improvements, while not dramatic, 
nonetheless address aimmon administrative issues. If managing 
mobile compuiers lias lieen time-consuming in tlie past. Leopard’s 
changes may lielp you manage laptops faster and more 
ccmsistenilv. 

7ili 
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Introduction 

Core Animation is arguably the jewel in the crown of 
OS X 10.5 Leopard. Core Animation is one of the features 
that Apple has been holding up as a prime reason to 
migrate your projects over to Leopard. In this article 1 am 
going to walk through the basics of Core Animation and 
how to add some simple Imt dazzling effects to your 
application. 

To quote Brent Simmons from NewsGator: “Core 
Animation makes everything taste better. ILs like hot sauce, 
except that everybody likes it,” 

Overview 

Core Animation allows me U> quickly and easily add 
visual effects to my applications that help it become more 
interesting and intuitive to the enchusen With Core 
Animation I can easily make views slide around the screen, 
appear, disappear, Hip or just about anything else 
imaginable. The important part of this is that rhi.s 
functionality can be added very easily. It does not take an 
expert in Quartz or OpenGL to perform these effects. 

In addition to being able to add these effects, Core 
Animation plays nice with the existing visual technologies. 
I can use Core Animation with my existing Quartz, 
Quicklime and OpenGL views without having to migrate 
everything over to one API. 

But what is Core Animation? Core Animation is a set of 
APIs that allow developers to change IJJ elements over a 
period of time without having to generate each step in the 
timeline. With Core Animation I can simply tell the UI 
element to change x to y over n and forget about it. The 

will handle all of the tweening for me. 

Implicit Animations 

The best way to demonstrate this is by code. In the 
attached project, 1 created a basic Cocoa application from 
XCode's template. The first step, after creating the XCode 


project was to create the application's delegate class. As is 
pretty standard, 1 named this class AppDelegate, The 
AppDelegate has tw^o ivars (window and button) anci 

one action (move): 

©interface AppDelegate : NSObJect I 
lEOutlet tISWindow ’windowj 
IBOutlet NSButtgn ’button; 

[ 

- (IBAction)inove : (Id) sender: 

Once the AppDelegate was created I added the 
import statement to bring Core Animation into the class via: 
^import <QuartzCore/CQreAnimati(>n.h> 

QuartzGore * f ramework is al.su linked into the 
project. From there 1 opened tlie MainMenu.nib file in 
InterfaceBuilder. In the window (Figure 1) of this 
application I added one button called Move! 

Window 


< Move! ^ 


Figure 1. The Main Window 

I also wired (Figure 2) it into the AppDelegate that 1 
also created. 
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r Outlets 


1 but!on 

-: It Push Sutton 

« Win-dow ? 

- K Wmdow 

Received Actions 


m&ve y 

- M l^ih Button 


Figure 2. The button wired into the AppDelegate 

With tills complete in Interfiice Buiklet; it ifi time to add 
Functkmlity' to tlie - (void)move: (id)sender metliod to die 
AppDelegate itself: 

- (IBActlon)]no\^e: {id)sender: 

( 

NSRect frame = [button frame]: 
frairie.origin,K -== 10: 

[[button animator] setframeOrigin:frame.origin]; 

1 

Mien you buiki and am tliis application, the button will 
gently slide across the window to tlie left, 10 pixels at a time. 

Notice tliat die only special dting in this code is to m^ike a cal! 
to the button’s animator iasiead of the button itself. The animator 
is a new object included widi Leopard and Core Animation, 'fhe 
animaior Ls an NS Proxy object diat will accept any method call 
that is valid for its parent, in dus case die NSButton. What 
liappens when I make a call on die animaror, however, is dm it 
creates a CAEasic Animat ion in die background instead of 
changing the value directly on its parent, llierefore, the change is 
animated automatically. 

Explicit Animations 

But what if we want to automatic'ally move die button t>ack to 
its original kxation after it moves to tlte lelt? Tliat is a slightly more 
complicated animation and a good excuse to build die animation 
manually. 

When I want to do something more complex widi Core 
Animation then 1 need to turn die view into a layer-liacked view. 
The difference is that a layer-backed view has a light-weight cote 
animation layer attached to it. When 1 rmmipulate die layer, I am 
indirectly manipulating the view that it is attached to. 

In this example, 1 want to make the NSButton layer liacked 

so 1 have added one call in the - awakeFromNib : 

- (void)awakeFi:oinNib 
1 

[button setWatitsLuyetiYES] ; 

1 

Tliis call to the button teUs it to create a layer. This cull only 
needs to Lie made once per view and it will automatically turn on 
layer backing for any subviews. Tlierefore, if 1 wanted, I could 
liave called -setWantsLayer: on the contentView of the 
window instead and the button would have become layer Ijacked 
as weU. 

Once the view is layer backed, 1 can grab and manipulate the 
layer instead of die view. Therefore, I have changed die move 
mediod as follows: 
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- (IBAction)move:(id)sender: 

( 

CAEasioAnimatioTi ‘ttieAnlJiiation - [CABaalcAniination 
aniitiat ionWithKayPath: position * s'* ] : 

ItheAnimation setAutoreversestYES]: 

[tbeAnimation setToValue: [NSNuinber 
ntiinberWlthFloat:([ [button layer] p os it ion], x - 10)]]; 

[Ibutton layer] add Animat ion :theAiii]nat ion forKeyinil] ; 

[ 

When the -move: method fires, 1 first aeate a new 
CAAnimat ion object with a key path of position * x. As we 
know from key value coding, tliis key path points to the x variable 
of the position point of the referenced object. In this case, the 
referenced objea will be tlie layer backing tlie button 1 want to 
manipulate. 

The -setAutoreverses: call tells tlie animation tliat I want 
it to reverse itself when it is done. Normally an ardmation would 
start at its fromValue and complete at its toValue. However, 
when auto reverses is set to YES the to Value is only tlie 
mid point — the animation completes when it has returned to die 
f romValue. 

Notice diat I am only calling the - setToValue: and I am not 
calling - setFromValue:. Tills is because the f romValue Is 
defaulted to be the current value. Since that is wliai I want diere 
is no reason to set it again. 

Once 1 have set all of die properties on die aniniation dial 1 
need, I just need to add it to the layer for it to begin its work. Once 
I can - add Animat ion: forKey: Core Animation will E^ike over 
and perform the aniniadon. 

Animation Grouping 

To furdier diis example, 1 want to make die button fade out at 
the same lime iltat it moves. Naturally these are two .separate 
animadons but I want them to Ix" in perfect lock .step. To 
accomplish this, 1 want to wrap them in a CATransaction. 
One thing to note; Core Animation assumes a transaction if you are 
perfcjrming work in the same cycle of tlie am loop so you don’t 
really need a transaction for this example. However, if you are 
going to be doing more complex animations then it is a good liabit 
to be in. Since CATransaction objeas can be nested, I never 
know if I am going to lie adding one animation effect to another 
cad in the same run loop, 

[CATransaction begin]; 

CABasicAnimatlon ^moveAnlinatlon = [CABasicAnlmatior] 
animationWitMeyPath;@”positicin .xT] : 

[iDoveAniination setAutoreverseslYES); 

[moveAniination setToValue: [NSNunbet 
numberWitliFloat:([[button layer] poaitlon].x - 10)]] i 

1 [button layer] addAnlmation:movnAniniatlDn forXey:nil] ; 

CAEasicAnimation *fadeAniination ^ [CABaaicAnimation 
animat ionWithKeyPath: o p ac i ty '^ ] ■ 

[fadeAnimation setAutoreveraea:YES]; 

[fadeAnimation setToValue:[NSNumber numberWithFloat:0.Of]]: 
[[button layer] addAnimation:fadeAnlmation forKey:nil]; 
[CATransaction cooualTlr 

There are two major ctianges to this version of the move: 
mediod: 


First, the entire metliod is wrapped in -fbegin and -^commit 
calls to CATransaction. This creates an explicit transaction 
around diese two animatioas. 

Second, I have added the opacity animation. Like die move 
aniiimtion (! renamed the animations for clarity), it animates die 
opacity property on die layer from its current value (which is LOf 
at tills point) to O.Of and back again. 

One of tlie advantages of working inside of a 
CATransaction like thus is diat I can change values that impact 
tlie entire traasactkm. For exiimpie, if 1 want to change the duration 

of die animation, I can do so wadi one call; 

[CATransaction sotValue:[NSNamber numberW1thFloat:1,Of] 

forKey:kCATransactionAnimatlonlluration]i 

Ii should be noted that diLs value needs to be set liefore the 
animatiOTLS are added to the layer otlierwise the change will not be 
{lickcxJ up. The reason for diis Ls not readily apparent. When the 
animation gets added to the layer, the layer actually makes a copy 
of tile animation rather than just retaining a reference. This is 
lieneficial for many reasons including the ability to add the same 
animation to multiple objects, 

Ammatmg Transitions 

So far 1 have covered imfilicit animations, explicit animations 
and aniniiition groups. Another area of interest Ls animating the 
transition of one view to anotJier. For instance, 0’ I am building a 
wi7,aixl type dialog and 1 am swapping out view.s for die user to 
input data on, it is possible to animate tills swttp to give tlie user a 
more pleasant experience and nuike die traasition more intuitive. 
1b accomplisli tliis animation, a CATransition aniniation 
needs to lie initialized and then loaded into the contentView 
object’s animation dictionary for the key “subview.s”. Tlien, 
wlienever a sub view is manipulated, the animation will fire. 

For example, if I mtKlificd die awakeFromNib as follows: 

- (void)awakeFromNib 
f 

NSVlev *contentView “ [window contentView]: 

[contentView setWantsLayer:YES]; 

CATransition ^transition ^ [CATransition anltnation]: 
[transition setType:kCATransltlonMDveIn]; 

[tranaition aetSubtypeikCATranaitionFroinLeft]; 

[transition setDuration:!.Of]: 

[contentView setAnlmatIons:[NSDictlonary 
dlctiDnaryWitbObject: transition forKey :@’'subvlews'd ]; 

1 

Any changes to the sub views of the con tent'View 
would trigger the animation 1 liave defined. With this code in place, 
ii' I dien at some later point, called; 

- (IBAction)addPicture:fid)sender 
I 

NSImageView *tmageView = [[NSImageView alloc] 
initWitbFraineiNSMakeRect{ 10, 10, 50, 50) J; 

[itnageVlew BetlmageSnalitig-NSScaleToFit] ; 

[ituageView setImage:[NSImage imageNamed:@”testl.png'til: 

[[[window contentView] animator] addSubview:imageView] : 

1 

The user would .see a new contentView appear to slide 
into place from the left and take the place of the current view. 
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Direct Layer Manipulation 

In addition to being able to manipulate windows and views, 
it is also possible to instantiate layers directly and use them without 
a view attached. A layer, by itself, is a lightweiglit two dimensional 
plane in a tliree dimensional space. What this means is iliat while 
layers liave width and heiglit, they have no depth of tiieir ow^n. 
However, layers can have their Z-axis manipulated so that I can 
define tlie order in wliich layers apjxrar within the view, layers am 
also liave cxinteni such as an image or text. Finally layers have 
many properties tliat can be manipulated, such as borders, 
background colors, et. al, 

Creating a liasic layer is very simple. For ex^miple, to add a 

blue square to tlie demo projea involveij the following code: 

CAL^yer ‘layer ^ [CALayer layer]: 

tlayer setlounds:CGRectMake(0. 0, 150, 150)]: 

[layer setlackgroundColor:CGColorCreatGGenerlcRGB(O.Q< 0.0. 

1 . 0 . 1 . 0 ) 1 : 

Ilayer setPositlon:CGPointHake(50. 50)]: 

[layer setZPosition:-SO.Of]: 

[[coetentView layer] addSublayer:layer]: 

First I am creating ;m auto-released CALayer with a adl to 
-layer. Next, 1 am setting tlie size of die layer widi a call to its 
bounds. Then, I am .setting its background color to blue, setting its 
position relative to its p^irent, changing iis Z position to -50 and 
finally I add it to the content View. 

A couple of interesting things to ncjte here: 

First, all of the manipulation of die layer uses Core Foundation 
references instead of NS Object. Tliis was a bit confusing to me 
for quite a while but with the felea.se of the iPhone SDK it lias 
tecome clear. Core Animation was taigeted at die iPhone from die 
beginning and due ui the space and pixxiessing ability of die 
iPhone, Core Animation is meant to 1^ as light as passible. 
Tlierefore most of Core Animaticm works widi Cx>ie Foundations 
objects and references instead of NSObject, 

Second, to add the layer to the content View, 1 liad to 
actually add it to the contentView's layer and not the view' 
direcdy Since layers are lightw'eight, they c'an only l^e added to 
other layers and not to \iews or windows direcdy. 

CALayer objects are very flexible with regard to how they 
look and behave. For instance, to make the layer alx>ve more 
rounded with a border would only recjuire the following dianges: 

[layer aetCornerKodiusilS^Of]: 

[layer aetBorderWldth:4.0f]; 

A layer can also be made tnmsparent, scaled, rotated and a 
large number of ocher changes* For example, it Is trivial to imitate 
niines Cover Flow using CALayer objects. 

CALayer objects can also l:)e animated easily. To extend the 
move example alx)ve: 

- (IBActioTijinove: (Id)sender: 

I 

[CATransantlcin begin] : 

[CATrenaaction setValue:[NSNumber numberWithFloat:!.Of] 
f 0 rKey:kCAT ransactionAnimationDuration]: 

CABasicAnunation 'inoveAnimation “ [CABasicAnLniatipn 
anlmtlonWlthKeyPath: @'*pos±tlDn. x" ] : 

[moveAnimation setAutoreverses:YES]: 

[moveAnimation setToValue:[NENuraber 
nuraberWithFloat:([[button layer] position],x ■ 10)]]; 
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[[button layer] addA nim atlon:moveAniiBatlQn forKey:nill: 
[layer addAnlmatioii:moveAnimaticiti forKey;nil] ; 

CABa^icAnimation *fadeAniiiiation “ [CABasicAniraiation 
an i Tna t lonWithKeyPath: g “ opacity"] : 

[fadeAnimation aetAutoreverses: )fES]: 

[fadeAniination setToValue:[NSNumber nmnberWithFloat:0.Of]]i 
[[button layer] addAnimation;fadeAnimation forKeyinil]; 
[layer addAnlmatlon;fadeAnimation forKey:nil]; 

[CAT ran sac tlon cotnmlt]; 

1 


The only changes I made to the -mcTve; method is adding die 
exact same animatiorLs to the layer that I added to the button. This 
is possible because the layer makes a copy of the ^tnimatitm object 
instead of just a [eference. 

Conclusion 

This is just a .small taste of the power of Core Animation in 
Letipard, For each of the examples in this article* tliere are 
tliousands of variation.s that are possible and piobabiy thoiksands 
of others that no one has thought of yet. 

Ykioks and articles are just now starting to come out to cover 
thus very exciting API and 1 recommend experimenting with it to 
dist:oveT all of its capabilities. 
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What attracts you to working on the Mac? 

Alex: Pertbmiance, Security and OS X being a IJNfX-derivate. 
Peter: Ease of use due to the Mac’s unrivaled user interface; Cocoa, 


What's the coolest thing about the Mac? 
Peter: The illuminated Apple logo. 


What do you do? 

Alex: Creative Director, Supporter, Sales Guy, Charmer 
- unless I’m busy codin' 

Peter: CVO (Chief Visionary Officer); Code Monkey 


How long have you been doing what you do? 

Alex: Working as a part of Many Tricks about a year, amither year for 
various companies. 

Peter: I started developing applications on my Atari (“first 
computer^ back in 1990i when I was 14. Creating a full-fledged 
graphics editor (including a font creation tool) with Omikron Basic 
took me almost a year. 


Where can we see a sample of your work? 

Alex: nianytricks.com 

Peter: On your Mac, ideally. If not, visit petermourerde/software 
for an overview of Mac projects Pve been working on. 

The next way Fm going to impact IT/OS X/the Mac universe is: 

- Alex; Revealed secrets aren’t secrets anymore, ;-) 

- Peter: Mac software. Oh, wait. Tliat’s also die current way. 

Any other detail you'd like us to feature? 

Your company or home URL; 
http: //WWW. m anytri cks xom 


What was your first computer; 
Alex: Macintosh Plus 
Peter: Atari 1040 STEM 


Are you Mac-only, or a multi-platform persoa? 
Alex: multi-platfonn person - OS X. Linux, Windows 


If you or someone you know befot^s in the MmTech ^tBgkt, kt us know! Send defies to e(litcirfd@ina€tecli.n3m 
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Oiifis for V^ds B Girads 


At Small Dog Electronics, we carry the newest Mac products, as well as the tried-and-true 
models you love. Right now, we have Mac Books in stock with up to $600 off their original 
prices— perfect for your favorite dad or grad. Many models are stocked with RAM, and our 
bundles offer the largest selection of MacBook savings around. 

Visit Smalldog.com to find yours today! 

hr&n Vfiore 'Reasons to Gkop Gma.[ldo^.com 

Many of our specials include free shipping, and every order outside of Vermont is always 
tax-free. Our friendly, knowledgeable staff is always ready to help with any question you 
may have. 



Small Dog 

Electronics 

2>U) TAou.r Qde 


brand new webslle 
over 3,000 producis 
5'Star online merchant rating 
lax-iree shopping outside oi VT! 


800>511'MAC$ 


Apple Specialist 


www.smalldog.com 
















Our passion* 


Mcmsoft 



Work together. Different machines? Different platforms? No matter. You can all speak the same language 




IMIOOS. 
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